GW2RegisterOutFile

Sinopsis

Bagi sesi session, fungsi GW2RegisterOutFile mendaftarkan fail yang namanya ialah rentetan yang ditunjukkan oleh outputFileBuffer sebagai fail destinasi untuk fail terurus yang dihasilkan oleh Glasswall. Nama asas laluan tersebut mestilah berbeza daripada nama asas yang didaftarkan menggunakan fungsi GW2RegisterInputFile. Menggunakan fungsi ini mengaktifkan Manage & Protect Process Mode untuk sesi tersebut.

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

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Contoh

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

Sinopsis

public int RegisterOutFile(
    int session,
    string outputFilePath)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

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

Nota

Parameter fungsi GW2RegisterOutFile telah dikemas kini untuk menggunakan String menggantikan byte[]. Fungsi asal telah ditandakan sebagai deprecated.

Pulangan

Fungsi GW2RegisterOutFile mengembalikan enumerasi GW2_RetStatus yang ditukarkan kepada int. Nilainya akan negatif jika ralat berlaku. 0 menunjukkan kejayaan. Rujuk API Overview/Return types untuk butiran lanjut.

Pengecualian NullPointerException akan dilemparkan jika outputFilePath adalah null atau kosong.

Pengecualian GlasswallException akan dilemparkan jika session tidak sah, jika outputFilePath tidak dapat diperoleh, atau jika outputFilePath tidak dapat ditukarkan kepada UTF-8.

Sinopsis

Daftarkan fail output untuk sesi yang diberikan. Jika output_file ialah None, fail akan dikembalikan sebagai atribut 'buffer' dan '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.
    """

Pulangan

gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'status' yang menunjukkan hasil panggilan fungsi. Jika output_file ialah None (mod memori), 'buffer' dan 'buffer_length' disertakan yang mengandungi kandungan fail dan saiz fail.

Atribut status ialah nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

Fungsi ini mendaftarkan fail destinasi untuk fail terurus yang dihasilkan oleh 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)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.