GW2RegisterExportTextDumpMemory

Sinopsis

Bagi sesi session, fungsi GW2RegisterExportTextDumpMemory mendaftarkan lokasi text dump untuk kandungan yang dieksport perlu diletakkan, dan lokasi untuk meletakkan saiz dalam bait bagi kandungan text dump tersebut. Penuding kepada kandungan text dump akan diletakkan dalam objek yang ditunjukkan oleh exportTextDumpFileBuffer dan saiz dalam bait bagi data text dump akan diletakkan dalam objek size_t yang ditunjukkan oleh exportTextDumpLength. Kandungan text dump akan dipadamkan apabila sesi ditutup menggunakan GW2CloseSession. Menggunakan fungsi ini mengaktifkan pilihan Text Dump untuk Export Process Mode bagi sesi tersebut.

#include "glasswall.core2.api.h"
int GW2RegisterExportTextDumpMemory(Session session,
                            char **exportTextDumpFileBuffer,
                            size_t *exportTextDumpLength);

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

public int RegisterTextDumpMemory(
    int session,
    out IntPtr textDumptFileBufferPtr,
    ref UIntPtr textDumpBufferLengthPtr)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterExportTextDumpMemory(int session) throws GlasswallException

Penerangan

Fungsi GW2RegisterExportTextDumpMemory mendaftarkan penimbal memori sebagai output untuk text dump yang dieksport bagi sesi yang ditentukan oleh session. Panggil GetTextDumpBuffer selepas memanggil GW2RunSession untuk mendapatkan data text dump yang dieksport.

Pulangan

Fungsi GW2RegisterExportTextDumpMemory 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[] GetTextDumpBuffer(int session) throws GlasswallException

Penerangan

Mendapatkan kandungan penimbal text dump yang dieksport yang dikaitkan dengan sesi yang ditentukan oleh session.

Pulangan

Mengembalikan byte[] yang mengandungi text dump yang dieksport. Tatasusunan bait ini akan menjadi null jika GW2RegisterExportTextDumpMemory dan GW2RunSession belum dipanggil.

Pengecualian GlasswallException akan dibaling jika `session``` tidak sah.

Sinopsis

Mendaftarkan penimbal memori sebagai output untuk text dump yang dieksport bagi sesi yang diberikan. Text dump akan dicipta semasa panggilan run_session sesi tersebut.

def _GW2RegisterExportTextDumpMemory(self, session: int):
    """ Registers an export text dump to be written in memory.

    Args:
        session (int): The session integer.

    Returns:
        gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attributes 'session', 'buffer', 'buffer_length', 'status'.
    """

Pulangan

gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'session', 'buffer', 'buffer_length', 'status'.

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

Longgokan teks boleh ditukar kepada bait selepas run_session dipanggil menggunakan glasswall.utils.buffer_to_bytes.

Contoh

import glasswall


editor = glasswall.Editor(r"<path to dir containing Glasswall libraries>")

input_file = r"<path to an input file>"

with open(input_file, "rb") as f:
    input_file_memory = f.read()

with editor.new_session() as session:
    register_input = editor._GW2RegisterInputMemory(session, input_file_memory)
    register_export = editor._GW2RegisterExportMemory(session)
    register_export_text_dump_memory = editor._GW2RegisterExportTextDumpMemory(session)
    status = editor.run_session(session)

    file_session_status = editor._GW2FileSessionStatus(session)
    file_error_message = editor._GW2FileErrorMsg(session)

    file_bytes = glasswall.utils.buffer_to_bytes(
        register_export.buffer,
        register_export.buffer_length
    )
    text_dump = glasswall.utils.buffer_to_bytes(
        register_export_text_dump_memory.buffer,
        register_export_text_dump_memory.buffer_length
    )

Sinopsis

Fungsi ini mendaftarkan lokasi memori longgokan teks eksport terhadap sesi yang ditentukan.

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

GW2RegisterExportTextDumpMemory(session, exportTextDumpFileBuffer, exportTextDumpLength)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.