GW2RegisterLicenceFile

Sinopsis

Fungsi GW2RegisterLicenceFile meminta supaya sesi session menggunakan lesen yang ditentukan dalam fail yang namanya ialah rentetan yang ditunjukkan oleh filename. Lesen tersebut akan digunakan pada semua pemprosesan yang dilakukan oleh Glasswall untuk sesi itu.

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

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 (GW2RegisterLicenceFile(session, "gwkey.lic") < 0)
            /* deal with error */
        else
            /* the file has been successfully registered */

    ...

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

Sinopsis

Kaedah RegisterLicenceFile meminta supaya sesi session menggunakan lesen yang ditentukan dalam fail yang namanya ialah rentetan yang ditunjukkan oleh filename. Lesen tersebut akan digunakan pada semua pemprosesan yang dilakukan oleh Glasswall untuk sesi itu.

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

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor 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

Nota

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

Pulangan

Fungsi GW2RegisterLicenceFile 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 NullPointerException akan dibaling jika licenceFilePath ialah null atau kosong.

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

Pendaftaran lesen bagi setiap sesi dikendalikan secara automatik dalam pembungkus Python, dan pengguna tidak perlu memanggil GW2RegisterLicenceFile atau GW2RegisterLicenceMemory secara manual.

Secara lalai, kelas Editor menjangkakan fail lesen yang sah berada dalam direktori yang sama dengan library_path. Anda juga boleh menentukan laluan berbeza ke fail lesen 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 boleh menghantar data lesen dalam 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

Kaedah RegisterLicenceFile meminta supaya sesi session menggunakan lesen yang ditentukan dalam fail yang namanya ialah rentetan yang ditunjukkan oleh filename. Lesen tersebut akan digunakan pada semua pemprosesan yang dilakukan oleh Glasswall untuk sesi itu.

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

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.