LsaQueryTrustedDomainInfo 함수(ntsecapi.h)

아티클
08/08/2024

LsaQueryTrustedDomainInfo 함수는 신뢰할 수 있는 도메인에 대한 정보를 검색합니다.

구문

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

매개 변수

[in] PolicyHandle

TrustedDomainSid 매개 변수로 식별된 도메인과 트러스트 관계가 있는 도메인 컨트롤러의 Policy 개체에 대한 핸들입니다. 핸들에 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.

[in] TrustedDomainSid

쿼리할 신뢰할 수 있는 도메인의 SID에 대한 포인터입니다.

[in] InformationClass

TRUSTED_INFORMATION_CLASS 열거형 형식에서 다음 값 중 하나를 지정합니다. 값은 요청되는 정보의 유형을 나타냅니다.

값	의미
TrustedDomainNameInformation	신뢰할 수 있는 도메인의 이름을 검색합니다. Buffer 매개 변수는 TRUSTED_DOMAIN_NAME_INFO 구조체에 대한 포인터를 받습니다.
TrustedPosixOffsetInformation	신뢰할 수 있는 도메인에 대한 Posix 사용자 및 그룹 식별자를 생성하는 데 사용되는 값을 검색합니다. Buffer 매개 변수는 TRUSTED_POSIX_OFFSET_INFO 구조체에 대한 포인터를 받습니다.
TrustedPasswordInformation	신뢰할 수 있는 도메인의 암호를 검색합니다. Buffer 매개 변수는 TRUSTED_PASSWORD_INFO 구조체에 대한 포인터를 받습니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_GET_PRIVATE_INFORMATION 액세스 권한이 있어야 합니다.
TrustedDomainInformationEx	신뢰할 수 있는 도메인에 대한 확장 정보를 검색합니다. Buffer 매개 변수는 TRUSTED_DOMAIN_INFORMATION_EX 구조체에 대한 포인터를 받습니다.
TrustedDomainInformationBasic	이 값은 지원되지 않습니다.
TrustedDomainFullInformation	신뢰할 수 있는 도메인에 대한 전체 정보를 검색합니다. 이 정보에는 Posix 오프셋 정보, 인증 정보 및 TrustedDomainInformationEx 값에 대해 반환된 확장 정보가 포함됩니다. Buffer 매개 변수는 TRUSTED_DOMAIN_FULL_INFORMATION 구조체에 대한 포인터를 받습니다.

[out] Buffer

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

정보 사용을 마쳤으면 반환된 포인터를 LsaFreeMemory에 전달하여 해제합니다.

반환 값

함수가 성공하면 함수는 STATUS_SUCCESS 반환합니다.

함수가 실패하면 오류를 나타내는 NTSTATUS 값을 반환합니다. 자세한 내용은 LSA 정책 함수 반환 값을 참조하세요.

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

요구 사항

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