GW2RegisterLicenceFile

Sinopsis

Fungsi GW2RegisterLicenceFile meminta agar sesi session menggunakan lisensi yang ditentukan dalam file yang namanya adalah string yang ditunjuk oleh filename. Lisensi akan diterapkan pada semua pemrosesan yang dilakukan oleh Glasswall untuk sesi tersebut.

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

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.

Contoh

    #include "glasswall.core2.api.h"

    HANDLE session = GW2OpenSession();
    if (!session)
        /* deal with error */
    else
        if (GW2RegisterLicenceFile(session, "gwkey.lic") < 0)
            /* deal with error */
        else
            /* the file has been successfully registered */

    ...

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

Sinopsis

Metode RegisterLicenceFile meminta agar sesi session menggunakan lisensi yang ditentukan dalam file yang namanya adalah string yang ditunjuk oleh filename. Lisensi akan diterapkan pada semua pemrosesan yang dilakukan oleh Glasswall untuk sesi tersebut.

    /// <param name="session">Current open Glasswall session</param>
    /// <param name="filePath">The file path to the licence file to be registered</param>
    public int RegisterLicenceFile(int session, string filePath)

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterLicenceFile(int session, String licenceFilePath) throws GlasswallException, NullPointerException

(Deprecated)
public int GW2RegisterLicenceFile(int session, byte[] licenceFilePath) throws GlasswallException, NullPointerException

Catatan

Parameter fungsi GW2RegisterLicenceFile telah diperbarui untuk menggunakan String sebagai pengganti byte[]. Fungsi aslinya telah ditandai sebagai deprecated.

Hasil pengembalian

Fungsi GW2RegisterLicenceFile mengembalikan enumerasi GW2_RetStatus yang dikonversi menjadi int. Nilainya akan negatif jika terjadi kesalahan. 0 menunjukkan keberhasilan. Lihat API Overview/Return types untuk detailnya.

Pengecualian NullPointerException akan dilempar jika licenceFilePath bernilai null atau kosong.

Pengecualian GlasswallException akan dilempar jika session tidak valid, jika licenceFilePath tidak dapat diambil, atau jika licenceFilePath tidak dapat dikonversi ke UTF-8.

Pendaftaran lisensi untuk setiap sesi ditangani secara otomatis dalam wrapper Python, dan pengguna tidak perlu memanggil GW2RegisterLicenceFile atau GW2RegisterLicenceMemory secara manual.

Secara default, class Editor mengharapkan file lisensi yang valid berada di direktori yang sama dengan library_path. Anda juga dapat menentukan jalur berbeda ke file lisensi gwkey.lic menggunakan argumen licence.

import glasswall


# Load the Glasswall Editor library with a specified licence file
editor = glasswall.Editor(r"C:\gwpw\libraries\10.0", licence=r"C:\gwpw\licence\gwkey.lic")

Sebagai alternatif, Anda dapat meneruskan data lisensi di memori sebagai objek bytes, bytearray, atau io.BytesIO.

import glasswall


# Alternatively, load the licence from in-memory bytes or bytearray
with open(r"C:\gwpw\licence\gwkey.lic", "rb") as f:
    licence_data = f.read()

editor = glasswall.Editor(
    r"C:\gwpw\libraries\10.0", 
    licence=licence_data  # In-memory licence data
)

Sinopsis

Metode RegisterLicenceFile meminta agar sesi session menggunakan lisensi yang ditentukan dalam file yang namanya adalah string yang ditunjuk oleh filename. Lisensi akan diterapkan pada semua pemrosesan yang dilakukan oleh Glasswall untuk sesi tersebut.

    /**
     * Sets what licence file should be loaded for the session.
     * @param {number} session The ID of the session.
     * @param {string} filename The filename from which to load the licence.
     * @returns {number} Status of the operation; 0 for success, non-zero for failure.
     */
    GW2RegisterLicenceFile(session, filename)

Hasil pengembalian

Mengembalikan nilai enum GW2_RetStatus berupa integer. Angka negatif menunjukkan kegagalan.