GW2RegisterOutFile

개요

세션 session에 대해 GW2RegisterOutFile 함수는 outputFileBuffer가 가리키는 문자열 이름을 가진 파일을 Glasswall이 생성한 관리 대상 파일의 대상 파일로 등록합니다. 경로의 base name은 GW2RegisterInputFile 함수를 사용해 등록한 base name과 달라야 합니다. 이 함수를 사용하면 해당 세션에 대해 Manage & Protect Process Mode가 활성화됩니다.

#include "glasswall.core2.api.h"
int GW2RegisterOutFile(Session session, const char *outputFilePath);

반환값

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

예제

    #include "glasswall.core2.api.h"

    HANDLE session = GW2OpenSession();
    if (!session)
        /* deal with error */
    else
    {
        if (GW2RegisterOutFile(session, "managed_file.docx") < 0)
            /* deal with error */
        else
            /* continue processing */
            ...
    }

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

개요

public int RegisterOutFile(
    int session,
    string outputFilePath)

반환값

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

개요

import com.glasswall.core2javabridge.*;

public int GW2RegisterOutFile(int session, String outputFilePath) throws GlasswallException, NullPointerException

(Deprecated)
public int GW2RegisterOutFile(int session, byte[] outputFilePath) throws GlasswallException, NullPointerException

참고

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

반환값

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

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

A GlasswallException exception will be thrown if session is invalid, if the outputFilePath could not be retrieved, or if the outputFilePath could not be converted to UTF-8.

개요

지정된 세션에 대해 출력 파일을 등록합니다. output_file이 None이면 파일은 'buffer' 및 'buffer_length' 속성으로 반환됩니다.

def register_output(self, session, output_file: Optional[str] = None):
    """ Register an output file for the given session. If output_file is None the file will be returned as 'buffer' and 'buffer_length' attributes.

    Args:
        session (int): The session integer.
        output_file (Optional[str]): If specified, during run session the file will be written to output_file, otherwise the file will be written to the glasswall.GwReturnObj 'buffer' and 'buffer_length' attributes.

    Returns:
        gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attribute 'status' indicating the result of the function call. If output_file is None (memory mode), 'buffer', and 'buffer_length' are included containing the file content and file size.
    """

반환값

gw_return_object (glasswall.GwReturnObj): 함수 호출 결과를 나타내는 'status' 속성이 있는 GwReturnObj 인스턴스입니다. output_file이 None(메모리 모드)인 경우 파일 내용과 파일 크기를 포함하는 'buffer' 및 'buffer_length'도 포함됩니다.

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

개요

이 함수는 Glasswall에서 생성한 관리 파일의 대상 파일을 등록합니다.

/**
 * @param {number} session The ID of the session.
 * @param {string} outputFilePath The specified output path. Must be different to the specified input file path.
 */

GW2RegisterOutFile(
    session,
    outputFilePath)

반환값

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