LsaEnumerateTrustedDomainsEx 함수(ntsecapi.h)

  • 아티클

LsaEnumerateTrustedDomainsEx 함수는 로컬 시스템에서 신뢰하는 도메인에 대한 정보를 반환합니다. LsaEnumerateTrustedDomainsEx는 직접 트러스트에 대한 정보만 반환합니다. 보다 완전한 신뢰 열거를 위해 DsEnumerateDomainTrusts를 사용하는 것이 좋습니다.

구문

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

매개 변수

[in] PolicyHandle

Policy 개체에 대한 핸들입니다. 이 호출을 사용하려면 Policy 개체에 대한 POLICY_VIEW_LOCAL_INFORMATION 액세스 권한이 필요합니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.

[in] EnumerationContext

LsaEnumerateTrustedDomainsEx를 여러 번 호출하여 신뢰할 수 있는 모든 도메인 정보를 검색하는 데 사용할 수 있는 LSA_ENUMERATION_HANDLE 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

[out] Buffer

열거된 신뢰할 수 있는 도메인에 대한 정보를 포함하는 TRUSTED_DOMAIN_INFORMATION_EX 구조 목록을 수신하는 버퍼에 대한 포인터입니다.

애플리케이션은 LsaFreeMemory를 호출하여 더 이상 필요하지 않은 경우 이 버퍼를 해제해야 합니다.

[in] PreferedMaximumLength

반환된 데이터의 기본 설정 최대 길이(바이트)입니다. 이것은 하드 상한이 아니지만 가이드 역할을합니다. 자연 데이터 크기가 다른 시스템 간의 데이터 변환으로 인해 반환되는 실제 데이터 양이 이 값보다 클 수 있습니다.

[out] CountReturned

반환된 신뢰할 수 있는 도메인 개체 수를 수신하는 LONG 에 대한 포인터입니다.

반환 값

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

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

값 Description
STATUS_ACCESS_DENIED
 호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다.
STATUS_NO_MORE_ENTRIES
 더 이상 항목이 없습니다. EnumerationContext 값이 너무 높기 때문에 열거된 개체가 없으면 이 경고가 반환됩니다.
 

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

설명

모든 신뢰 정보를 검색하려면 LsaEnumerateTrustedDomainsEx 호출이 하나 이상 필요할 수 있습니다.

EnumerationContext 매개 변수를 사용하여 여러 호출을 수행하려면

  1. EnumerationContext가 가리키는 변수를 0으로 설정합니다.
  2. LsaEnumerateTrustedDomainsEx가 STATUS_SUCCESS 또는 STATUS_MORE_ENTRIES 반환하는 경우 함수를 다시 호출하여 이전 호출에서 반환된 EnumerationContext 값을 전달합니다.
  3. 함수가 STATUS_NO_MORE_ENTRIES 반환하면 열거형이 완료됩니다.

요구 사항

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

추가 정보

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX