GW2RegisterPoliciesFile

Sinopsis

Fungsi GW2RegisterPoliciesFile meminta agar session menggunakan policy yang ditentukan dalam file yang namanya adalah string yang ditunjuk oleh filename. Format policy tersebut mengikuti format yang ditentukan oleh format. Policy akan diterapkan ke semua pemrosesan yang dilakukan oleh Glasswall untuk sesi tersebut.

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

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 (GW2RegisterPoliciesFile(session, "Office_Binary_Policies.xml",  PF_XML) < 0)
            /* deal with error */
        else
            /* the file has been successfully registered */

    ...

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

Sinopsis

Mendaftarkan ke sesi yang dirujuk oleh session, file yang ditunjuk oleh policiesFilePath, dengan format yang ditentukan oleh policiesFormat

/// <param name="session">ID number for the session</param>
/// <param name="policiesFilePath">The file path to the file to be processed</param>
/// <param name="policiesFormat">Format of the policy file</param>
public int RegisterPoliciesFile(
    int session,
    string policiesFilePath,
    int policiesFormat

Hasil pengembalian

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

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterPoliciesFile(int session, String policiesFilePath, int format) throws GlasswallException, NullPointerException

(Deprecated)
public int GW2RegisterPoliciesFile(int session, byte[] policiesFilePath, int format) throws GlasswallException, NullPointerException

Deskripsi

Lihat API Overview/Return types untuk enumerator yang valid bagi format.

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

Hasil pengembalian

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

Exception NullPointerException akan dilempar jika policiesFilePath bernilai null atau kosong.

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

Sinopsis

Menetapkan konfigurasi policy manajemen konten. Jika input_file adalah None maka pengaturan default (sanitise) diterapkan.

def set_content_management_policy(self, session: int, input_file: Union[None, str, bytes, bytearray, io.BytesIO, "glasswall.content_management.policies.policy.Policy"] = None, policy_format=0):
    """ Sets the content management policy configuration. If input_file is None then default settings (sanitise) are applied.

    Args:
        session (int): The session integer.
        input_file (Union[None, str, bytes, bytearray, io.BytesIO, glasswall.content_management.policies.policy.Policy], optional): Default None (sanitise). The content management policy to apply.
        policy_format (int): The format of the content management policy. 0=XML.

    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', 'policy_format', 'status'.

            - If input_file is a file in memory:
                - gw_return_object (glasswall.GwReturnObj): A GwReturnObj instance with the attributes 'session', 'buffer', 'buffer_length', 'policy_format', 'status'.
    """

Hasil pengembalian

Sebuah objek dengan atribut yang berbeda tergantung pada tipe input_file.

• Jika input_file adalah path file str:

  • gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'session', 'input_file', 'policy_format', 'status'.

• Jika input_file adalah file di memori:

  • gw_return_object (glasswall.GwReturnObj): Instance GwReturnObj dengan atribut 'session', 'buffer', 'buffer_length', 'policy_format', 'status'.

Atribut status adalah nilai enum bilangan bulat GW2_RetStatus. Angka negatif menunjukkan kegagalan.

Sinopsis

Fungsi ini meminta agar sesi yang ditentukan menggunakan policy dalam file yang ditentukan.

/**
 * @param {number} session The ID of the session.
 * @param {string} filename The filename from which to load policy settings.
 * @param {number} format - The format of the policy to be registered.
 */

GW2RegisterPoliciesFile(
    session,
    filename,
    format)

Hasil pengembalian

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