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 |
|---|---|
|
호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다. |
|
더 이상 항목이 없습니다. EnumerationContext 값이 너무 높기 때문에 열거된 개체가 없으면 이 경고가 반환됩니다. |
LsaNtStatusToWinError 함수를 사용하여 NTSTATUS 코드를 Windows 오류 코드로 변환할 수 있습니다.
설명
모든 신뢰 정보를 검색하려면 LsaEnumerateTrustedDomainsEx 호출이 하나 이상 필요할 수 있습니다.
EnumerationContext 매개 변수를 사용하여 여러 호출을 수행하려면
- EnumerationContext가 가리키는 변수를 0으로 설정합니다.
- LsaEnumerateTrustedDomainsEx가 STATUS_SUCCESS 또는 STATUS_MORE_ENTRIES 반환하는 경우 함수를 다시 호출하여 이전 호출에서 반환된 EnumerationContext 값을 전달합니다.
- 함수가 STATUS_NO_MORE_ENTRIES 반환하면 열거형이 완료됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntsecapi.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |