GW2RegisterExportMemory

Sinopsis

Bagi session session, fungsi GW2RegisterExportMemory mendaftarkan tempat kandungan yang dieksport akan diletakkan, dan tempat untuk meletakkan saiz dalam bait bagi kandungan yang dieksport. Penuding kepada kandungan yang dieksport akan diletakkan dalam objek yang ditunjuk oleh exportFileBuffer dan saiz dalam bait bagi data yang dieksport akan diletakkan dalam objek size_t yang ditunjuk oleh exportFileBufferLength. Kandungan yang dieksport akan dipadamkan apabila session ditutup menggunakan GW2CloseSession. Menggunakan fungsi ini mengaktifkan Export Process Mode untuk session tersebut.

#include "glasswall.core2.api.h"
int GW2RegisterExportMemory(Session session,
                            char **exportFileBuffer,
                            size_t *exportFileBufferLength);

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

public int RegisterExportMemory(
    int session,
    out IntPtr exportFileBufferPtr,
    ref UIntPtr exportBufferLengthPtr)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterExportMemory(int session) throws GlasswallException

Penerangan

Fungsi GW2RegisterExportMemory mendaftarkan penimbal memori untuk digunakan sebagai output bagi fail yang dieksport, untuk sesi yang ditentukan oleh session. Panggil GetExportBuffer selepas memanggil GW2RunSession untuk mendapatkan semula data yang dieksport.

Pulangan

Fungsi GW2RegisterExportMemory 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 GlasswallException akan dilemparkan jika session tidak sah.

Sinopsis - Dapatkan Data

import com.glasswall.core2javabridge.*;

public byte[] GetExportBuffer(int session) throws GlasswallException

Penerangan

Fungsi GetExportBuffer mendapatkan kandungan penimbal eksport yang dikaitkan dengan sesi yang ditentukan oleh session.

Pulangan

Fungsi GetExportBuffer mengembalikan byte[] yang mengandungi fail yang dieksport. Nilai ini akan menjadi null jika GW2RegisterExportMemory dan GW2RunSession belum dipanggil, atau jika fail tersebut tidak mematuhi spesifikasi.

Pengecualian GlasswallException akan dilemparkan jika session tidak sah.

Sinopsis

Mendaftarkan fail untuk dieksport bagi sesi yang diberikan. Fail eksport akan dicipta semasa panggilan run_session sesi tersebut.

def register_export(self, session: int, output_file: Optional[str] = None):
    """ Registers a file to be exported for the given session. The export 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 export will be written. None exports the file in memory.

    Returns:
        gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attribute 'status' indicating the result of the function call and 'session', the session integer. 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 dan 'session', iaitu integer session. 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 lokasi memori eksport terhadap sesi yang ditentukan.

/**
*
* @param {number} session The ID of the session.
* @param {string} exportFileBuffer A pointer to the specified memory location.
* @param {number} exportLength The size of the file buffer.
*/

GW2RegisterExportMemory(session, exportFileBuffer, exportLength)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.