GW2RegisterExportTextDumpMemory

Tóm tắt

Đối với phiên session, hàm GW2RegisterExportTextDumpMemory đăng ký nơi đặt text dump cho nội dung đã xuất, và nơi đặt kích thước tính bằng byte của nội dung text dump. Một con trỏ tới nội dung text dump sẽ được đặt trong đối tượng mà exportTextDumpFileBuffer trỏ tới và kích thước tính bằng byte của dữ liệu text dump sẽ được đặt trong đối tượng size_t mà exportTextDumpLength trỏ tới. Nội dung text dump sẽ bị xóa khi phiên được đóng bằng GW2CloseSession. Việc sử dụng hàm này kích hoạt tùy chọn Text Dump cho Export Process Mode của phiên.

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

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.

Tóm tắt

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

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.

Tóm tắt

import com.glasswall.core2javabridge.*;

public int GW2RegisterExportTextDumpMemory(int session) throws GlasswallException

Mô tả

Hàm GW2RegisterExportTextDumpMemory đăng ký một bộ đệm bộ nhớ làm đầu ra cho text dump đã xuất của phiên được chỉ định bởi session. Gọi GetTextDumpBuffer sau khi đã gọi GW2RunSession để truy xuất dữ liệu text dump đã xuất.

Giá trị trả về

Hàm GW2RegisterExportTextDumpMemory trả về một giá trị liệt kê GW2_RetStatus được chuyển đổi thành int. Giá trị sẽ là số âm nếu xảy ra lỗi. 0 cho biết thành công. Tham khảo API Overview/Return types để biết chi tiết.

Một ngoại lệ GlasswallException sẽ được ném ra nếu session không hợp lệ.

Tóm tắt - Truy xuất dữ liệu

import com.glasswall.core2javabridge.*;

public byte[] GetTextDumpBuffer(int session) throws GlasswallException

Mô tả

Truy xuất nội dung của bộ đệm text dump đã xuất được liên kết với phiên được chỉ định bởi session.

Giá trị trả về

Trả về một byte[] chứa text dump đã xuất. Mảng byte này sẽ là null nếu GW2RegisterExportTextDumpMemory và GW2RunSession chưa được gọi.

Một ngoại lệ GlasswallException sẽ được ném ra nếu `session``` không hợp lệ.

Tóm tắt

Đăng ký một bộ đệm bộ nhớ làm đầu ra cho text dump đã xuất cho phiên đã cho. Text dump sẽ được tạo trong lệnh gọi run_session của phiên.

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

Giá trị trả về

gw_return_object (glasswall.GwReturnObj): Một thực thể GwReturnObj với các thuộc tính 'session', 'buffer', 'buffer_length', 'status'.

Thuộc tính status là một giá trị enum GW2_RetStatus kiểu số nguyên. Các số âm cho biết thất bại.

Text dump có thể được chuyển đổi thành bytes sau khi run_session đã được gọi bằng cách sử dụng glasswall.utils.buffer_to_bytes.

Ví dụ

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
    )

Tóm tắt

Hàm này đăng ký một vị trí bộ nhớ kết xuất văn bản xuất cho một phiên được chỉ định.

/**
*
* @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)

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.