GW2RegisterAnalysisMemory

सारांश

GW2RegisterAnalysisMemory function, analysisFileBuffer द्वारा इंगित object में, API function runSession के सफल run द्वारा उत्पन्न analysis report का pointer संग्रहीत करता है, जिसने session session का उपयोग किया था। analysis report का आकार, bytes में, analysisLength द्वारा इंगित object में रखा जाता है। analysis report का format, format द्वारा अनुरोधित format में होगा। इस function का उपयोग करने से session के लिए Analysis Process Mode सक्रिय हो जाता है।

#include "glasswall.core2.api.h"

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

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

उदाहरण

#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 */

सारांश

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

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

सारांश

import com.glasswall.core2javabridge.*;

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

विवरण

GW2RegisterAnalysisMemory function, session द्वारा निर्दिष्ट session के लिए, analysis report के output के रूप में एक memory buffer register करता है। analysis report प्राप्त करने के लिए GW2RunSession को कॉल करने के बाद GetAnalysisBuffer या GetAnalysisReport को कॉल करें।

format के लिए मान्य enumerators हेतु API Overview/Return types देखें।

रिटर्न

GW2RegisterAnalysisMemory function, GW2_RetStatus enumeration को int में convert करके लौटाता है। यदि कोई त्रुटि हुई है तो मान negative होगा। 0 सफलता को दर्शाता है। विवरण के लिए API Overview/Return types देखें।

A GlasswallException exception will be thrown if session is invalid.

सारांश - डेटा प्राप्त करें

import com.glasswall.core2javabridge.*;

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

विवरण

GetAnalysisBuffer फ़ंक्शन session द्वारा निर्दिष्ट session से संबद्ध analysis report buffer की सामग्री प्राप्त करता है।

रिटर्न

GetAnalysisBuffer फ़ंक्शन analysis report युक्त एक Byte[] लौटाता है। GetAnalysisReport फ़ंक्शन analysis report युक्त एक String लौटाता है। यदि GW2RunSession और GW2RegisterAnalysisMemory दोनों को कॉल नहीं किया गया है, तो ये null होंगे।

A GlasswallException exception will be thrown if session is invalid.

सारांश

दिए गए session के लिए एक analysis file पंजीकृत करता है। analysis file session के run_session call के दौरान बनाई जाएगी।

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.
    """

रिटर्न

gw_return_object (glasswall.GwReturnObj): 'status', 'session', 'analysis_format' attributes के साथ एक GwReturnObj instance। यदि output_file None है (memory mode), तो file content और file size को शामिल करते हुए 'buffer' और 'buffer_length' शामिल होते हैं। यदि output_file None नहीं है (file mode) तो 'output_file' शामिल होता है।

status attribute एक integer GW2_RetStatus enum value है। Negative numbers विफलता को दर्शाते हैं।

सारांश

यह फ़ंक्शन runSession के सफल run द्वारा उत्पन्न analysis report के लिए एक pointer संग्रहीत करता है।

/**
 *
 * @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)

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।