LsaOpenTrustedDomainByName 함수(ntsecapi.h)

LsaOpenTrustedDomainByName 함수는 원격 신뢰할 수 있는 도메인의 LSA 정책 핸들을 엽니다. 원격 머신의 LSA 정책을 설정하거나 쿼리하기 위해 이 핸들을 LSA 함수 호출에 전달할 수 있습니다.

구문

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

매개 변수

[in] PolicyHandle

Policy 개체에 대한 핸들입니다. 로컬 컴퓨터의 정책 핸들입니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.

[in] TrustedDomainName

신뢰할 수 있는 도메인의 이름입니다. 이 이름은 플랫 이름 또는 DNS(Domain Name System) 도메인 이름일 수 있습니다.

[in] DesiredAccess

원격 신뢰할 수 있는 도메인 개체에 대해 요청된 액세스 권한을 지정하는 ACCESS_MASK 구조체입니다.

[out] TrustedDomainHandle

원격 신뢰할 수 있는 도메인의 LSA 정책 핸들 주소를 받는 포인터입니다. 원격 머신의 LSA 정책을 쿼리하고 관리하기 위해 이 핸들을 LSA 함수 호출에 전달할 수 있습니다.

애플리케이션에 이 핸들이 더 이상 필요하지 않으면 LsaClose를 호출하여 핸들을 삭제해야 합니다.

반환 값

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

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

값	Description
STATUS_ACCESS_DENIED	호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다.
STATUS_OBJECT_NAME_NOT_FOUND	대상 시스템의 LSA 데이터베이스에 지정된 이름을 가진 신뢰할 수 있는 도메인 개체가 없습니다.

 

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

요구 사항

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

추가 정보

LsaClose