GW2RegisterExportTextDumpMemory

सारांश

session session के लिए, GW2RegisterExportTextDumpMemory फ़ंक्शन यह register करता है कि exported content के लिए text dump कहाँ रखा जाएगा, और text dump content का size bytes में कहाँ रखा जाएगा। text dump content के लिए एक pointer उस object में रखा जाएगा जिसकी ओर exportTextDumpFileBuffer संकेत करता है, और text dump data का size bytes में उस size_t object में रखा जाएगा जिसकी ओर exportTextDumpLength संकेत करता है। जब session को GW2CloseSession का उपयोग करके बंद किया जाएगा, तब text dump content हटा दिया जाएगा। इस फ़ंक्शन का उपयोग करने से session के लिए Export Process Mode का Text Dump विकल्प सक्रिय हो जाता है।

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

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

सारांश

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

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

सारांश

import com.glasswall.core2javabridge.*;

public int GW2RegisterExportTextDumpMemory(int session) throws GlasswallException

विवरण

GW2RegisterExportTextDumpMemory फ़ंक्शन session द्वारा निर्दिष्ट session के लिए exported text dump के output के रूप में एक memory buffer को register करता है। exported text dump data प्राप्त करने के लिए GW2RunSession को कॉल करने के बाद GetTextDumpBuffer को कॉल करें।

रिटर्न

GW2RegisterExportTextDumpMemory फ़ंक्शन GW2_RetStatus enumeration को int में convert करके लौटाता है। यदि कोई त्रुटि हुई है, तो मान negative होगा। 0 सफलता को दर्शाता है। विवरण के लिए API Overview/Return types देखें।

A GlasswallException exception will be thrown if session is invalid.

सारांश - डेटा प्राप्त करें

import com.glasswall.core2javabridge.*;

public byte[] GetTextDumpBuffer(int session) throws GlasswallException

विवरण

session द्वारा निर्दिष्ट session से संबद्ध exported text dump buffer की सामग्री प्राप्त करता है।

रिटर्न

exported text dump को शामिल करने वाला एक byte[] लौटाता है। यदि GW2RegisterExportTextDumpMemory और GW2RunSession को कॉल नहीं किया गया है, तो यह byte array null होगा।

यदि `session``` अमान्य है, तो GlasswallException exception throw किया जाएगा।

सारांश

दिए गए session के लिए exported text dump के output के रूप में एक memory buffer को register करता है। text dump session के run_session call के दौरान बनाया जाएगा।

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

रिटर्न

gw_return_object (glasswall.GwReturnObj): 'session', 'buffer', 'buffer_length', 'status' attributes वाला एक GwReturnObj instance।

status attribute एक integer GW2_RetStatus enum value है। Negative numbers विफलता को दर्शाते हैं।

run_session को कॉल किए जाने के बाद text dump को glasswall.utils.buffer_to_bytes का उपयोग करके bytes में convert किया जा सकता है।

उदाहरण

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
    )

सारांश

यह फ़ंक्शन किसी निर्दिष्ट session के लिए export text dump memory location को register करता है।

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

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।