LsaQueryTrustedDomainInfoByName 함수(ntsecapi.h)

LsaQueryTrustedDomainInfoByName 함수는 신뢰할 수 있는 도메인에 대한 정보를 반환합니다.

구문

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

매개 변수

[in] PolicyHandle

Policy 개체에 대한 핸들입니다. 이 핸들에는 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.

[in] TrustedDomainName

신뢰할 수 있는 도메인의 이름을 포함하는 문자열입니다. 도메인 이름 또는 플랫 이름일 수 있습니다.

[in] InformationClass

검색할 정보의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
TrustedDomainNameInformation	신뢰할 수 있는 도메인의 이름입니다.
TrustedPosixInformation	신뢰할 수 있는 도메인의 Posix 오프셋입니다.
TrustedPasswordInformation	트러스트의 아웃바운드 쪽에 있는 암호를 반환합니다.
TrustedDomainInformationBasic	이 값은 지원되지 않습니다.
TrustedDomainInformationEx	기본 정보 및 DNS 도메인 이름 및 트러스트에 대한 특성을 포함하여 확장된 신뢰 정보입니다.
TrustedDomainFullInformation	Posix 오프셋 및 인증 정보를 포함한 전체 정보입니다.

[out] Buffer

요청된 정보를 포함하는 반환된 버퍼에 대한 포인터를 받습니다. 이 버퍼의 형식과 콘텐츠는 정보 클래스에 따라 달라집니다. 예를 들어 InformationClass 가 TrustedDomainInformationEx로 설정된 경우 버퍼 는 TRUSTED_DOMAIN_INFORMATION_EX 구조체에 대한 포인터를 받습니다. 자세한 내용은 TRUSTED_INFORMATION_CLASS 참조하세요.

버퍼 사용을 마쳤으면 LsaFreeMemory 함수를 호출하여 버퍼를 해제합니다.

반환 값

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

함수가 실패하면 다음 값 중 하나 또는 LSA 정책 함수 반환 값 중 하나일 수 있는 NTSTATUS 값을 반환합니다.

값	Description
STATUS_ACCESS_DENIED	호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다. 필요한 액세스 형식 목록은 InformationClass 매개 변수에 대한 설명을 참조하세요.
리소스 STATUS_INSUFFICIENT_	메모리와 같은 시스템 리소스가 부족하여 호출을 완료할 수 없습니다.

 

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

요구 사항

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

추가 정보

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS