LsaQueryInformationPolicy 함수(ntsecapi.h)

아티클
03/15/2023

LsaQueryInformationPolicy 함수는 Policy 개체에 대한 정보를 검색합니다.

구문

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

매개 변수

[in] PolicyHandle

Policy 개체에 대한 핸들입니다. 이 핸들에 필요한 액세스 권한은 InformationClass 매개 변수의 값에 따라 달라집니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.

[in] InformationClass

POLICY_INFORMATION_CLASS 열거형 형식에서 다음 값 중 하나를 지정합니다. 값은 검색할 정보의 형식을 나타냅니다.

값	의미
PolicyAuditEventsInformation	시스템의 감사 규칙을 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_AUDIT_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_AUDIT_EVENTS_INFO 구조체에 대한 포인터를 받습니다.
PolicyPrimaryDomainInformation	시스템 기본 도메인의 이름 및 SID를 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_PRIMARY_DOMAIN_INFO 구조체에 대한 포인터를 받습니다.
PolicyAccountDomainInformation	시스템 계정 도메인의 이름 및 SID를 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_ACCOUNT_DOMAIN_INFO 구조체에 대한 포인터를 받습니다.
PolicyLsaServerRoleInformation	LSA 서버의 역할을 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_LSA_SERVER_ROLE_INFO 구조체에 대한 포인터를 받습니다.
PolicyModificationInformation	LSA 데이터베이스의 생성 시간 및 마지막 수정에 대한 정보를 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_MODIFICATION_INFO 구조체에 대한 포인터를 받습니다.
PolicyDnsDomainInformation	Policy 개체와 연결된 기본 도메인에 대한 DNS(도메인 이름 시스템) 정보를 검색합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_DNS_DOMAIN_INFO 구조체에 대한 포인터를 받습니다.

[out] Buffer

요청된 정보를 포함하는 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체의 형식은 InformationClass 매개 변수의 값에 따라 달라집니다.

정보가 더 이상 필요하지 않으면 반환된 포인터를 LsaFreeMemory에 전달합니다.

반환 값

LsaQueryInformationPolicy 함수가 성공하면 반환 값이 STATUS_SUCCESS.

함수가 실패하면 반환 값은 NTSTATUS 코드입니다. 자세한 내용은 LSA 정책 함수 반환 값을 참조하세요.

LsaNtStatusToWinError 함수를 사용하여 NTSTATUS 코드를 Windows 오류 코드로 변환할 수 있습니다.

설명

이 함수를 호출하는 방법을 보여 주는 예제는 정책 정보 관리를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntsecapi.h
라이브러리	Advapi32.lib
DLL	Advapi32.dll