GW2RegisterInputFile

Sinopsis

Fungsi GW2RegisterInputFile mendaftarkan fail yang akan diproses dalam session session. Nama fail ialah rentetan yang ditunjukkan oleh inputFilePath.

#include "glasswall.core2.api.h"
int GW2RegisterInputFile(Session session, const char *inputFilePath);

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
{
    if (GW2RegisterInputFile(session, "filename.doc") < 0)
        /* deal with error */
    else
        /* continue processing */
        ...
}

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

Sinopsis

public int RegisterInputFile(
    int session,
    string inputFilePath)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterInputFile(int session, String inputFilePath) throws GlasswallException, NullPointerException

(Deprecated)
public int GW2RegisterInputFile(int session, byte[] inputFilePath) throws GlasswallException, NullPointerException

Nota

Parameter fungsi GW2RegisterInputFile telah dikemas kini untuk menggunakan String menggantikan byte[]. Fungsi asal telah ditandakan sebagai deprecated.

Pulangan

Fungsi GW2RegisterInputFile 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 NullPointerException akan dilemparkan jika inputFilePath ialah null atau kosong.

Pengecualian GlasswallException akan dilemparkan jika session tidak sah, jika inputFilePath tidak dapat diperoleh, atau jika inputFilePath tidak dapat ditukarkan kepada UTF-8.

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 ditentukan sebagai fail input untuk session yang ditentukan

/**
 *
 * @param {number} session The ID of the session.
 * @param {string} inputFilePath The path of the file to be registered
 */

GW2RegisterInputFile(session, inputFilePath)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.