GW2RegisterLicenceFile

Tóm tắt

Hàm GW2RegisterLicenceFile yêu cầu phiên session sử dụng giấy phép được chỉ định trong tệp có tên là chuỗi được trỏ tới bởi filename. Giấy phép sẽ được áp dụng cho mọi xử lý do Glasswall thực hiện cho phiên đó.

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

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.

Ví dụ

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

Tóm tắt

Phương thức RegisterLicenceFile yêu cầu phiên session sử dụng giấy phép được chỉ định trong tệp có tên là chuỗi được trỏ tới bởi filename. Giấy phép sẽ được áp dụng cho mọi xử lý do Glasswall thực hiện cho phiên đó.

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

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.

Tóm tắt

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

Lưu ý

Các tham số của hàm GW2RegisterLicenceFile đã được cập nhật để sử dụng String thay cho byte[]. Hàm gốc đã bị ngừng sử dụng.

Giá trị trả về

Hàm GW2RegisterLicenceFile trả về một giá trị liệt kê GW2_RetStatus được chuyển đổi thành int. Giá trị sẽ là số âm nếu xảy ra lỗi. 0 cho biết thành công. Tham khảo API Overview/Return types để biết chi tiết.

Một ngoại lệ NullPointerException sẽ được ném ra nếu licenceFilePath là null hoặc rỗng.

Một ngoại lệ GlasswallException sẽ được ném ra nếu session không hợp lệ, nếu không thể truy xuất licenceFilePath, hoặc nếu không thể chuyển đổi licenceFilePath sang UTF-8.

Việc đăng ký giấy phép cho từng phiên được xử lý tự động trong Python wrapper và người dùng không cần gọi thủ công GW2RegisterLicenceFile hoặc GW2RegisterLicenceMemory.

Theo mặc định, lớp Editor yêu cầu một tệp giấy phép hợp lệ nằm trong cùng thư mục với library_path. Bạn cũng có thể chỉ định một đường dẫn khác tới tệp giấy phép gwkey.lic bằng đối số 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")

Ngoài ra, bạn có thể truyền dữ liệu giấy phép trong bộ nhớ dưới dạng đối tượng bytes, bytearray hoặc 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
)

Tóm tắt

Phương thức RegisterLicenceFile yêu cầu phiên session sử dụng giấy phép được chỉ định trong tệp có tên là chuỗi được trỏ tới bởi filename. Giấy phép sẽ được áp dụng cho mọi xử lý do Glasswall thực hiện cho phiên đó.

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

Giá trị trả về

Trả về một giá trị enum GW2_RetStatus dạng số nguyên. Các số âm cho biết thất bại.