GW2GetPolicySettings

#include "glasswall.core2.api.h"

int GW2GetPolicySettings (
    Session session,
    char **policiesBuffer,
    size_t *policiesLength,
    Policy_format format);

पैरामीटर

  session session की ID, जैसा कि GW2OpenSession द्वारा लौटाया गया है

  policiesBuffer एक string pointer output parameter है, जिसे policy settings information से भरा जाता है। इस pointer द्वारा उपयोग की गई memory को user द्वारा मुक्त करने की आवश्यकता नहीं है। विफलता की स्थिति में यह parameter nullptr पर सेट किया जा सकता है।

  policiesLength एक output parameter है, जिसे policiesBuffer द्वारा इंगित memory के bytes में आकार से भरा जाता है

  format डेटा का format। यह PF_XML होना चाहिए।

रिटर्न

  एक integer लौटाता है जो बताता है कि function call सफल रहा या नहीं। Negative numbers विफलता को दर्शाते हैं। return codes की व्याख्या के लिए Return Types तालिका देखें।

सारांश

/// <summary>
/// Retrieves policy settings for the session
/// </summary>
/// <param name="session">Current open Glasswall session</param>
/// <param name="policiesBufferPtr">A pointer to the object containing a pointer pointing to the policy data</param>
/// <param name="policiesLengthPtr">A pointer to a object containing the size in bytes </param>
public  int GetPolicySettings(
    int session,
    out IntPtr policiesBufferPtr,
    ref UIntPtr policiesLengthPtr,
    int format)

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

सारांश

import com.glasswall.core2javabridge.*;

public String GW2GetPolicySettingsString(int session, int format) throws GlasswallException

नोट

GW2GetPolicySettingsString फ़ंक्शन session द्वारा निर्दिष्ट सत्र के लिए वर्तमान में पंजीकृत policy settings आउटपुट करता है।

format के लिए मान्य enumerators हेतु API Overview/Return types देखें।

इस functionality के लिए पहले policy setting data को पुनर्प्राप्त करने हेतु दो अलग-अलग function calls की आवश्यकता होती थी। अब इसे सरल बनाकर settings को String के रूप में लौटाया जाता है। मूल दो functions को deprecated कर दिया गया है।

रिटर्न

GW2GetPolicySettingsString फ़ंक्शन policy settings युक्त एक String लौटाता है।

A GlasswallException exception will be thrown if session is invalid, or if the policy settings could not be retrieved.

सारांश - अप्रचलित फ़ंक्शन

import com.glasswall.core2javabridge.*;

(Deprecated)
public int GW2GetPolicySettings(int session, int format) throws GlasswallException
public byte[] GetPolicyBuffer(int session) throws GlasswallException

विवरण - Deprecated Functions

GW2GetPolicySettings function, session द्वारा निर्दिष्ट session के लिए वर्तमान में registered policy settings को internal policy buffer में output करता है। इस data को GetPolicyBuffer function का उपयोग करके प्राप्त करें।

format के लिए मान्य enumerators हेतु API Overview/Return types देखें।

रिटर्न्स - अप्रचलित फ़ंक्शन

GW2GetPolicySettings function, GW2_RetStatus enumeration को int में convert करके return करता है। यदि कोई त्रुटि हुई है, तो मान negative होगा। 0 सफलता को दर्शाता है। विवरण के लिए API Overview/Return types देखें।

GetPolicyBuffer एक byte[] return करता है जिसमें policy settings होती हैं। यदि GW2GetPolicySettings को call नहीं किया गया है, तो यह null होगा।

A GlasswallException exception will be thrown if session is invalid, or if the policy settings could not be retrieved.

सारांश

दिए गए session के लिए content management configuration return करता है।

def get_content_management_policy(self, session: int):
    """ Returns the content management configuration for a given session.

    Args:
        session (int): The session integer.

    Returns:
        xml_string (str): The XML string of the current content management configuration.
    """

रिटर्न

xml_string (str): वर्तमान content management configuration की XML string

सारांश

/**
 * This function returns the policy settings used for the specified session
 *
 * @param {number} session The ID of the session.
 * @param {string} policiesBuffer The pointer to the policy buffer.
 * @param {number} policiesLength The size of the data in the policy buffer
 * @param {number} format The format of the policy.
 */

GW2GetPolicySettings(
    session,
    policiesBuffer,
    policiesLength,
    format)

रिटर्न

एक पूर्णांक GW2_RetStatus enum मान लौटाता है। नकारात्मक संख्याएँ विफलता को दर्शाती हैं।

उदाहरण

const ref = require('ref-napi');

...

function buffer_to_string(buffer, buffer_size) {

    if (!buffer.isNull() && ref.deref(buffer_size) > 0) {
        return Buffer.from(ref.reinterpret(ref.deref(buffer), ref.deref(buffer_size), 0)).toString();
    }
    else {
        return "";
    }
}

...

let policy_file_buffer = ref.alloc(ref.refType(ref.types.CString));
let policy_buffer_size = ref.alloc(ref.types.size_t, 0);

let return_status = gw.GW2GetPolicySettings(session_id, policy_file_buffer, policy_buffer_size, 0);
let xml_string = buffer_to_string(policy_file_buffer, policy_buffer_size);

...