GW2RegisterAnalysisMemory

Buod

Iniimbak ng GW2RegisterAnalysisMemory function sa object na tinutukoy ng analysisFileBuffer ang pointer sa analysis report na nalikha ng matagumpay na pagpapatakbo ng API function na runSession na gumamit ng session na session. Ang laki ng analysis report, sa bytes, ay inilalagay sa object na tinutukoy ng analysisLength. Ang format ng analysis report ay magiging nasa format na hiniling ng format. Ang paggamit ng function na ito ay nag-a-activate ng Analysis Process Mode para sa session.

#include "glasswall.core2.api.h"

int GW2RegisterAnalysisMemory(Session session,
                              char **analysisFileBuffer,
                              size_t analysisLength,
                              Analysis_format format);

Ibinabalik

Nagbabalik ng integer na GW2_RetStatus enum value. Ang mga negatibong numero ay nagpapahiwatig ng pagkabigo.

Halimbawa

#include "glasswall.core2.api.h"

Session_Handle session;
char *analysisReport = NULL;
size_t analysisReportSize = 0;

session = GW2OpenSession();

if (!session)
    /* deal with error */
else
{
    if (GW2RegisterAnalysisMemory(session, &analysisReport, &analysisReportSize, PF_XML) < 0)
        /* deal with error */
    else
        /* analysisReport points to the analysis report data */
}

/* later */
if (GW2CloseSession(session) < 0)
    /* error closing session */

Buod

public int RegisterAnalysisMemory(
    int session,
    out IntPtr analysisBufferPtr,
    ref UIntPtr analysisBufferLengthPtr,
    int Format)

Ibinabalik

Nagbabalik ng integer na GW2_RetStatus enum value. Ang mga negatibong numero ay nagpapahiwatig ng pagkabigo.

Buod

import com.glasswall.core2javabridge.*;

public int GW2RegisterAnalysisMemory(int session, int format) throws GlasswallException

Paglalarawan

Ang GW2RegisterAnalysisMemory function ay nagrerehistro ng memory buffer bilang output para sa analysis report, para sa session na tinukoy ng session. Tawagin ang GetAnalysisBuffer o GetAnalysisReport pagkatapos tawagin ang GW2RunSession upang makuha ang analysis report.

Sumangguni sa API Overview/Return types para sa mga wastong enumerator para sa format.

Ibinabalik

Ang GW2RegisterAnalysisMemory function ay nagbabalik ng GW2_RetStatus enumeration na na-convert sa int. Magiging negatibo ang value kung may naganap na error. Ang 0 ay nagpapahiwatig ng tagumpay. Sumangguni sa API Overview/Return types para sa mga detalye.

Isang GlasswallException exception ang ita-throw kung hindi valid ang session.

Buod - Kunin ang Data

import com.glasswall.core2javabridge.*;

public byte[] GetAnalysisBuffer(int session) throws GlasswallException
public String GetAnalysisReport(int session) throws GlasswallException

Paglalarawan

Ang function na GetAnalysisBuffer ay kumukuha ng nilalaman ng analysis report buffer na nauugnay sa session na tinukoy ng session.

Ibinabalik

Ang function na GetAnalysisBuffer ay nagbabalik ng isang Byte[] na naglalaman ng analysis report. Ang function na GetAnalysisReport ay nagbabalik ng isang String na naglalaman ng analysis report. Ang mga ito ay magiging null kung ang parehong GW2RunSession at GW2RegisterAnalysisMemory ay hindi pa natawag.

Isang GlasswallException exception ang ita-throw kung hindi valid ang session.

Buod

Nagrerehistro ng analysis file para sa ibinigay na session. Malilikha ang analysis file sa panahon ng run_session call ng session.

def register_analysis(self, session: int, output_file: Optional[str] = None):
    """ Registers an analysis file for the given session. The analysis file will be created during the session's run_session call.

    Args:
        session (int): The session integer.
        output_file (Optional[str]): Default None. The file path where the analysis will be written. None returns the analysis as bytes.

    Returns:
        gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attributes 'status', 'session', 'analysis_format'. If output_file is None (memory mode), 'buffer', and 'buffer_length' are included containing the file content and file size. If output_file is not None (file mode) 'output_file' is included.
    """

Ibinabalik

gw_return_object (glasswall.GwReturnObj): Isang instance ng GwReturnObj na may mga attribute na 'status', 'session', 'analysis_format'. Kung ang output_file ay None (memory mode), kasama ang 'buffer' at 'buffer_length' na naglalaman ng nilalaman ng file at laki ng file. Kung ang output_file ay hindi None (file mode), kasama ang 'output_file'.

Ang status attribute ay isang integer na GW2_RetStatus enum value. Ang mga negatibong numero ay nagpapahiwatig ng failure.

Buod

Iniimbak ng function na ito ang isang pointer sa analysis report na ginawa ng matagumpay na pagpapatakbo ng runSession.

/**
 *
 * @param {number} session The ID of the session.
 * @param {string} analysisFileBuffer The pointer to the location of the analysis report.
 * @param {number} analysisOutputLength The size of the analysis report.
 * @param {number} format The specified format.
 */

GW2RegisterAnalysisMemory(
    session,
    analysisFileBuffer,
    analysisOutputLength,
    format)

Ibinabalik

Nagbabalik ng integer na GW2_RetStatus enum value. Ang mga negatibong numero ay nagpapahiwatig ng pagkabigo.