GW2RegisterPoliciesMemory

Sinopsis

Bagi sesi session, fungsi GW2RegisterPoliciesMemory mendaftarkan policy yang akan digunakan oleh Glasswall semasa memproses fail. policies ialah penuding kepada data policy, policiesLength menentukan saiz dalam bait bagi data policy, dan policiesFormat menentukan format data policy.

    #include "glasswall.core2.api.h"
    int GW2RegisterPoliciesMemory(Session session,
                                  const char *policies,
                                  size_t policiesLength,
                                  Policy_format format);

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Contoh

    #include "glasswall.core2.api.h"

    Session session = GW2OpenSession();
    char *policies = NULL;
    size_t size = 0;
    if (!session)
        /* deal with error */
    else
    {
        /* ... load 'policies' with a pointer to the policies content ... */
        if (GW2RegisterPoliciesMemory(session, policies, size, PF_XML) < 0)
            /* deal with error */
        else
            /* continue processing */
    }

    . . .

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

Sinopsis

Mendaftarkan policy yang akan digunakan oleh Glasswall semasa memproses fail

/// <param name="session">Session ID number</param>
/// <param name="policies">The policy file</param>
/// <param name="policiesFormat">Format of the policies data</param>
public int RegisterPoliciesMemory(
    int session,
    byte[] policies,
    int policiesFormat)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

import com.glasswall.core2javabridge.*;

public int GW2RegisterPoliciesMemory(int session, byte[] policiesBuffer, int format) throws GlasswallException, NullPointerException

public int GW2RegisterPoliciesMemory(int session, byte[] policiesBuffer, int length, int format) throws GlasswallException, NullPointerException

Nota

Rujuk API Overview/Return types untuk enumerator yang sah bagi format.

length bagi policiesBuffer boleh ditentukan secara pilihan.

Pulangan

Fungsi GW2RegisterPoliciesMemory mengembalikan enumerasi GW2_RetStatus yang ditukarkan kepada int. Nilainya akan negatif jika ralat berlaku. 0 menunjukkan kejayaan. Rujuk API Overview/Return types untuk butiran lanjut.

Pengecualian GlasswallException akan dilemparkan jika session tidak sah. Pengecualian NullPointerException akan dilemparkan jika policiesBuffer adalah null atau kosong.

Sinopsis

Menetapkan konfigurasi policy pengurusan kandungan. Jika input_file ialah None maka tetapan lalai (sanitise) digunakan.

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'.
    """

Pulangan

Objek dengan atribut yang berbeza bergantung pada jenis input_file.

• Jika input_file ialah laluan fail str:

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

• Jika input_file ialah fail dalam memori:

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

Atribut status ialah nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.

Sinopsis

Fungsi ini meminta agar sesi yang ditentukan menggunakan polices yang disimpan dalam penimbal memori yang ditentukan.

/**
 * @param {number} session The ID of the session.
 * @param {string} policies A pointer to the policy data buffer.
 * @param {number} policiesLength The length of the data in the policy buffer.
 * @param {number} format The format of the policy.
 */

GW2RegisterPoliciesMemory(
    session,
    policies,
    policyLength,
    format)

Pulangan

Mengembalikan nilai enum integer GW2_RetStatus. Nombor negatif menunjukkan kegagalan.