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는 해시 기반이 됩니다.

요구 사항