GW2RegisterAnalysisFile

개요

GW2RegisterAnalysisFile 함수는 문자열 analysisFilePath가 가리키는 이름의 파일에, session session을 사용한 API 함수 runSession의 성공적인 실행으로 생성된 분석 보고서를 저장합니다. 이 함수를 사용하면 해당 session에 대해 Analysis Process Mode가 활성화됩니다.

#include "glasswall.core2.api.h"
int GW2RegisterAnalysisFile(Session session,
                            const char *analysisFilePath,
                            Analysis_format format);

반환값

정수 GW2_RetStatus enum 값을 반환합니다. 음수는 실패를 나타냅니다.

예제

    #include "glasswall.core2.api.h"

    Session session = GW2OpenSession();
    if (!session)
        /* deal with error */
    else
        if (GW2RegisterAnalysisFile(session, "c:\\analysis_files\\analysis_file_023.xml", AF_XML) < 0)
            /* deal with error */
        else
            /* analysis file registered */

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

개요

public int RegisterAnalysisFile(
    int session,
    string analysisFilePath,
    int analysisFormat)

반환값

정수 GW2_RetStatus enum 값을 반환합니다. 음수는 실패를 나타냅니다.

개요

import com.glasswall.core2javabridge.*;

public int GW2RegisterAnalysisFile(int session, String analysisFilePath, int format) throws GlasswallException, NullPointerException

(Deprecated)
public int GW2RegisterAnalysisFile(int session, byte[] analysisFilePath, int format) throws GlasswallException, NullPointerException

참고

The GW2RegisterAnalysisFile function parameters have been updated to use String in place of byte[]. The original function has been deprecated.

format에 유효한 열거자에 대해서는 API Overview/Return types를 참조하십시오.

반환값

GW2RegisterAnalysisFile 함수는 GW2_RetStatus 열거형을 int로 변환하여 반환합니다. 오류가 발생한 경우 값은 음수가 됩니다. 0은 성공을 나타냅니다. 자세한 내용은 API Overview/Return types를 참조하십시오.

NullPointerException 예외는 analysisFilePath가 null이거나 비어 있는 경우 발생합니다.

GlasswallException 예외는 session이 유효하지 않거나 analysisFilePath를 가져올 수 없는 경우 발생합니다.

개요

지정된 session에 대해 analysis file을 등록합니다. analysis file은 session의 run_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.
    """

반환값

gw_return_object (glasswall.GwReturnObj): 'status', 'session', 'analysis_format' 속성을 가진 GwReturnObj 인스턴스입니다. output_file이 None인 경우(메모리 모드) 파일 내용과 파일 크기를 포함하는 'buffer' 및 'buffer_length'가 포함됩니다. output_file이 None이 아닌 경우(파일 모드) 'output_file'이 포함됩니다.

status 속성은 정수 GW2_RetStatus enum 값입니다. 음수는 실패를 나타냅니다.

개요

이 함수는 지정된 형식에 따라 지정된 session에 지정된 파일을 등록합니다.

/**
 *
 * @param {number} session The ID of the session.
 * @param {string} analysisFilePathName The path of the file to be registered.
 * @param {number} format The specified format.
 */

GW2RegisterAnalysisFile(
    session,
    analysisFilePathName,
    format)

반환값

정수 GW2_RetStatus enum 값을 반환합니다. 음수는 실패를 나타냅니다.