GW2RegisterInputMemory

Sinopsis

Fungsi GW2RegisterInputMemory mendaftarkan fail yang disimpan dalam penimbal yang ditunjukkan oleh inputFileBuffer bersaiz inputLength bait, dengan sesi yang ditandakan oleh session.

#include "glasswall.core2.api.h"
int GW2RegisterInputMemory(Session session, const char *inputFileBuffer, size_t inputLength);

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Contoh

#include "glasswall.core2.api.h"
...
HANDLE session = GW2OpenSession();
if (!session)
    /* deal with error */
else
{
    /* ... load file contents into buffer 'buf' and log the file size in 'size' ... */
    if (GW2RegisterInputMemory(session, buf, size))
        /* deal with error */
    else
        /* continue processing */
        ...
}

/* later */
if (GW2CloseSession(session))
    /* error closing session */

Sinopsis

public int RegisterInputMemory(
    int session,
    byte[] inputFileBuffer)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterInputMemory(int session, byte[] inputFileBuffer) throws GlasswallException, NullPointerException

public int GW2RegisterInputMemory(int session, byte[] inputFileBuffer, int length) throws GlasswallException, NullPointerException

Nota

length bagi inputFileBuffer boleh ditentukan secara pilihan.

Pulangan

Fungsi GW2RegisterInputMemory mengembalikan enumerasi GW2_RetStatus yang ditukarkan kepada int. Nilainya akan menjadi negatif jika ralat berlaku. 0 menunjukkan kejayaan. Rujuk API Overview/Return types untuk butiran.

Pengecualian GlasswallException akan dibaling jika session tidak sah, atau jika penimbal input tidak dapat diperoleh.

Pengecualian NullPointerException akan dibaling jika penimbal inputFileBuffer adalah null atau kosong.

Sinopsis

Daftarkan fail input atau bait untuk session yang diberikan.

def register_input(self, session: int, input_file: Union[str, bytes, bytearray, io.BytesIO]):
    """ Register an input file or bytes for the given session.

    Args:
        session (int): The session integer.
        input_file (Union[str, bytes, bytearray, io.BytesIO]): The input file path or bytes.

    Returns:
        - result (glasswall.GwReturnObj): Depending on the input 'input_file':
            - If input_file is a str file path:
                - gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attributes 'session', 'input_file', 'status'.

            - If input_file is a file in memory:
                - gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attributes 'session', 'buffer', 'buffer_length', 'status'.
    """

Pulangan

Objek dengan atribut yang berbeza bergantung pada jenis input_file.

• If input_file is a str file path:
  • gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'session', 'input_file', 'status'.
• If input_file is a file in memory:
  • 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.

Sinopsis

Fungsi ini mendaftarkan fail yang disimpan dalam memori sebagai fail input untuk sesi yang ditentukan

/**
 * @param {number} session The ID of the session.
 * @param {string} inputFileBuffer A buffer holding the file data
 * @param {number} inputLength The size of the file buffer
 */

GW2RegisterInputMemory(session, inputFileBuffer, inputLength)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.