GW2RegisterExportMemory

Tóm tắt

Đối với session session, hàm GW2RegisterExportMemory đăng ký nơi nội dung đã xuất sẽ được đặt vào, và nơi đặt kích thước tính bằng byte của nội dung đã xuất. Một con trỏ tới nội dung đã xuất sẽ được đặt trong đối tượng được trỏ tới bởi exportFileBuffer và kích thước tính bằng byte của dữ liệu đã xuất sẽ được đặt trong đối tượng size_t được trỏ tới bởi exportFileBufferLength. Nội dung đã xuất sẽ bị xóa khi session được đóng bằng GW2CloseSession. Việc sử dụng hàm này kích hoạt Chế độ Quy trình Xuất cho session.

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

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 RegisterExportMemory(
    int session,
    out IntPtr exportFileBufferPtr,
    ref UIntPtr exportBufferLengthPtr)

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 GW2RegisterExportMemory(int session) throws GlasswallException

Mô tả

Hàm GW2RegisterExportMemory đăng ký một bộ đệm bộ nhớ để được sử dụng làm đầu ra cho tệp đã xuất, cho phiên được chỉ định bởi session. Gọi GetExportBuffer sau khi đã gọi GW2RunSession để truy xuất dữ liệu đã xuất.

Giá trị trả về

Hàm GW2RegisterExportMemory 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[] GetExportBuffer(int session) throws GlasswallException

Mô tả

Hàm GetExportBuffer truy xuất nội dung của bộ đệm xuất được liên kết với phiên được chỉ định bởi session.

Giá trị trả về

Hàm GetExportBuffer trả về một byte[] chứa tệp đã xuất. Giá trị này sẽ là null nếu GW2RegisterExportMemory và GW2RunSession chưa được gọi, hoặc nếu tệp không tuân thủ.

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 tệp để xuất cho session đã cho. Tệp xuất sẽ được tạo trong lần gọi run_session của session.

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

Giá trị trả về

gw_return_object (glasswall.GwReturnObj): Một thực thể GwReturnObj với thuộc tính 'status' cho biết kết quả của lệnh gọi hàm và 'session', là số nguyên session. Nếu output_file là None (chế độ bộ nhớ), 'buffer' và 'buffer_length' sẽ được bao gồm, chứa nội dung tệp và kích thước tệp.

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.

Tóm tắt

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

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

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.