GW2RegisterImportMemory
Fungsi GW2RegisterImportMemory mendaftarkan lokasi memori yang mengandungi fail pertukaran yang diperlukan untuk import. Fail pertukaran ialah fail zip yang dihasilkan daripada proses eksport dan lokasi memori disediakan oleh GW2RegisterExportMemory. Menggunakan fungsi GW2RegisterImportMemory mengaktifkan Mod Proses Import untuk sesi tersebut.
- C++
- C#
- Java
- Python
- JavaScript
#include "glasswall.core2.api.h"
int GW2RegisterImportMemory(Session session, char *importFileBuffer, size_t *importLength);
Parameter
session ID sesi seperti yang dikembalikan oleh GW2OpenSession.
importFileBuffer Lokasi memori yang mengandungi fail pertukaran yang diperlukan untuk import. Lokasi memori disediakan oleh GW2RegisterExportMemory dan fail tersebut mesti mematuhi format fail pertukaran.
importLength Panjang importFileBuffer dalam bait
Pulangan
Mengembalikan integer yang menunjukkan sama ada panggilan fungsi berjaya. Nombor negatif menunjukkan kegagalan. Lihat jadual Return Types untuk penjelasan tentang kod pulangan.
Sinopsis
public int RegisterImportMemory(
int session,
byte[] importFileBuffer)
Pulangan
Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.
Sinopsis
import com.glasswall.core2javabridge.*;
public int GW2RegisterImportMemory(int session, byte[] importBuffer) throws GlasswallException, NullPointerException
public int GW2RegisterImportMemory(int session, byte[] importBuffer, int length) throws GlasswallException, NullPointerException
Nota
Rujuk API Overview/Return types untuk enumerator yang sah bagi format.
length bagi fileBuffer boleh ditentukan secara pilihan.
Pulangan
Fungsi GW2RegisterImportMemory mengembalikan enumerasi GW2_RetStatus yang ditukarkan kepada int. Nilainya akan 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 import tidak dapat diperoleh.
Pengecualian NullPointerException akan dibaling jika penimbal importBuffer adalah null atau kosong.
Sinopsis
Mendaftarkan fail .zip untuk diimport bagi session yang diberikan. Fail yang dibina akan dicipta semasa panggilan run_session session tersebut.
def register_import(self, session: int, input_file: Union[str, bytes, bytearray, io.BytesIO]):
""" Registers a .zip file to be imported for the given session. The constructed file will be created during the session's run_session call.
Args:
session (int): The session integer.
input_file (Union[str, bytes, bytearray, io.BytesIO]): The input import file path or bytes.
Returns:
gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attribute 'status' indicating the result of the function call. If output_file is None (memory mode), 'buffer', and 'buffer_length' are included containing the file content and file size.
"""
Pulangan
gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'status' yang menunjukkan hasil panggilan fungsi. Jika output_file ialah None (mod memori), 'buffer' dan 'buffer_length' disertakan yang mengandungi kandungan fail dan saiz fail.
Atribut status ialah nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.
Sinopsis
Fungsi ini mendaftarkan lokasi memori import terhadap session yang ditentukan.
/**
* @param {number} session The ID of the session.
* @param {string} importFileBuffer A pointer to the specified memory location.
* @param {number} importLength The size of the file buffer.
*/
GW2RegisterImportMemory(session, import_File_Buffer, import_File_Buffer_Length)
Pulangan
Atribut status ialah nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.