GW2RegisterExportTextDumpMemory

Sinopsis

Untuk sesi session, fungsi GW2RegisterExportTextDumpMemory mendaftarkan tempat dump teks untuk konten yang diekspor akan ditempatkan, dan tempat ukuran dalam byte dari konten dump teks akan ditempatkan. Pointer ke konten dump teks akan ditempatkan dalam objek yang ditunjuk oleh exportTextDumpFileBuffer dan ukuran dalam byte dari data dump teks akan ditempatkan dalam objek size_t yang ditunjuk oleh exportTextDumpLength. Konten dump teks akan dihapus saat sesi ditutup menggunakan GW2CloseSession. Menggunakan fungsi ini mengaktifkan opsi Text Dump untuk Export Process Mode pada sesi.

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

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.

Sinopsis

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

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterExportTextDumpMemory(int session) throws GlasswallException

Deskripsi

Fungsi GW2RegisterExportTextDumpMemory mendaftarkan buffer memori sebagai output untuk dump teks yang diekspor untuk sesi yang ditentukan oleh session. Panggil GetTextDumpBuffer setelah memanggil GW2RunSession untuk mengambil data dump teks yang diekspor.

Hasil pengembalian

Fungsi GW2RegisterExportTextDumpMemory mengembalikan enumerasi GW2_RetStatus yang dikonversi menjadi int. Nilainya akan negatif jika terjadi kesalahan. 0 menunjukkan keberhasilan. Lihat API Overview/Return types untuk detailnya.

Pengecualian GlasswallException akan dilempar jika session tidak valid.

Sinopsis - Ambil Data

import com.glasswall.core2javabridge.*;

public byte[] GetTextDumpBuffer(int session) throws GlasswallException

Deskripsi

Mengambil isi buffer text dump yang diekspor yang terkait dengan sesi yang ditentukan oleh session.

Hasil pengembalian

Mengembalikan byte[] yang berisi text dump yang diekspor. Array byte ini akan bernilai null jika GW2RegisterExportTextDumpMemory dan GW2RunSession belum dipanggil.

Pengecualian GlasswallException akan dilempar jika `session``` tidak valid.

Sinopsis

Mendaftarkan buffer memori sebagai output untuk text dump yang diekspor untuk sesi yang diberikan. Text dump akan dibuat selama pemanggilan run_session sesi.

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'.
    """

Hasil pengembalian

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

Atribut status adalah nilai enum bilangan bulat GW2_RetStatus. Angka negatif menunjukkan kegagalan.

Text dump dapat dikonversi menjadi bytes setelah 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 text dump ekspor 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)

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.