LsaGetAppliedCAPIDs 함수(ntlsa.h)

LsaGetAppliedCAPIDs 함수는 특정 컴퓨터에 적용된 모든 CAP의 CAPID(중앙 액세스 정책) 식별자 배열을 반환합니다.

구문

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

매개 변수

[in, optional] SystemName

특정 컴퓨터의 이름을 포함하는 LSA_UNICODE_STRING 구조체에 대한 포인터입니다. 이름은 "ComputerName" 또는 "\ComputerName" 형식일 수 있습니다. 이 매개 변수가 NULL이면 함수는 로컬 컴퓨터의 CAPID를 반환합니다.

[out] CAPIDs

지정된 컴퓨터에서 사용할 수 있는 CAP를 식별하는 CAPID에 대한 포인터 배열을 수신하는 변수에 대한 포인터입니다. CAPID 사용을 마쳤으면 배열의 각 요소와 전체 배열에서 LsaFreeMemory 함수를 호출합니다.

[out] CAPIDCount

지정된 컴퓨터에서 사용할 수 있는 CAP 수를 수신하는 변수에 대한 포인터입니다. CAPIDs 매개 변수에 반환된 배열은 CAPIDCount 매개 변수와 동일한 수의 요소를 포함합니다.

반환 값

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

함수가 실패하면 반환 값은 LSA 정책 함수 반환 값 중 하나입니다. LsaNtStatusToWinError 함수를 사용하여 NTSTATUS 코드를 Windows 오류 코드로 변환할 수 있습니다.

설명

중앙 액세스 정책에 대한 자세한 내용은 지정된 컴퓨터의 도메인 컨트롤러에 있는 Active Directory에서 중앙 액세스 정책 개체의 특성을 쿼리할 수 있습니다. msAuthz-CentralAccessPolicyID 특성이 반환된 CAPID 중 하나와 일치하는 개체를 찾습니다.

요구 사항

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

추가 정보

중앙 집중식 권한 부여 정책