GW2GetPolicySettings

#include "glasswall.core2.api.h"

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

매개변수

  session GW2OpenSession에서 반환된 세션의 ID

  policiesBuffer policy settings 정보로 채워지는 문자열 포인터 출력 매개변수입니다. 이 포인터가 사용하는 메모리는 사용자가 해제할 필요가 없습니다. 실패가 발생한 경우 이 매개변수는 nullptr로 설정될 수 있습니다.

  policiesLength policiesBuffer가 가리키는 메모리의 바이트 단위 크기로 채워지는 출력 매개변수입니다.

  format 데이터의 형식입니다. 이는 PF_XML이어야 합니다.

반환값

  함수 호출이 성공했는지를 나타내는 정수를 반환합니다. 음수는 실패를 나타냅니다. 반환 코드에 대한 설명은 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 설정을 출력합니다.

format에 유효한 열거자에 대해서는 API Overview/Return types를 참조하십시오.

이 기능은 이전에는 policy 설정 데이터를 가져오기 위해 두 번의 별도 함수 호출이 필요했습니다. 이제는 이를 간소화하여 설정을 String으로 반환합니다. 기존의 두 함수는 deprecated되었습니다.

반환값

GW2GetPolicySettingsString 함수는 policy 설정을 포함하는 String을 반환합니다.

GlasswallException 예외는 session이(가) 유효하지 않거나 policy 설정을 가져올 수 없는 경우 발생합니다.

개요 - 지원 중단된 함수

import com.glasswall.core2javabridge.*;

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

설명 - 더 이상 사용되지 않는 함수

GW2GetPolicySettings 함수는 session으로 지정된 세션에 대해 현재 등록된 policy 설정을 내부 policy 버퍼에 출력합니다. 이 데이터는 GetPolicyBuffer 함수를 사용하여 가져오십시오.

format에 유효한 열거자에 대해서는 API Overview/Return types를 참조하십시오.

반환값 - 지원 중단된 함수

GW2GetPolicySettings 함수는 GW2_RetStatus 열거형을 int로 변환하여 반환합니다. 오류가 발생한 경우 값은 음수가 됩니다. 0은 성공을 나타냅니다. 자세한 내용은 API 개요/반환 형식을 참조하십시오.

GetPolicyBuffer는 policy 설정을 포함하는 byte[]를 반환합니다. GW2GetPolicySettings가 호출되지 않은 경우 이는 null입니다.

GlasswallException 예외는 session이(가) 유효하지 않거나 policy 설정을 가져올 수 없는 경우 발생합니다.

개요

지정된 세션에 대한 콘텐츠 관리 구성을 반환합니다.

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): 현재 콘텐츠 관리 구성의 XML 문자열

개요

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

...