DeriveCapabilitySidsFromName 함수(securitybaseapi.h)

이 함수는 기능 이름에서 두 개의 SID 배열을 생성합니다. 하나는 NT 기관을 사용하는 배열 그룹 SID이고 다른 하나는 AppAuthority를 사용하는 기능 SID 배열입니다.

구문

BOOL DeriveCapabilitySidsFromName(
  [in]  LPCWSTR CapName,
  [out] PSID    **CapabilityGroupSids,
  [out] DWORD   *CapabilityGroupSidCount,
  [out] PSID    **CapabilitySids,
  [out] DWORD   *CapabilitySidCount
);

매개 변수

[in] CapName

문자열 형식의 기능 이름입니다.

[out] CapabilityGroupSids

NTAuthority를 사용하는 GroupSid입니다.

[out] CapabilityGroupSidCount

배열의 GroupSid 수입니다.

[out] CapabilitySids

AppAuthority를 사용하는 CapabilitySids입니다.

[out] CapabilitySidCount

AppAuthority를 사용하는 CapabilitySid의 수입니다.

반환 값

함수가 성공하면 TRUE를 반환합니다.

함수가 실패하면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

호출자는 배열 자체에 할당된 메모리뿐만 아니라 를 호출 LocalFree하여 각 배열에서 반환되는 개별 SID를 해제해야 합니다.

레거시 기능(Win10 이전에 게시됨)의 애플리케이션 기능에 대해 계산된 SID는 게시된 SID와 동일하지만 서비스 그룹 기능 SID에 대한 SID는 해시 기반이 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	securitybaseapi.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Kernel32.dll