DeriveCapabilitySidsFromName 関数 (securitybaseapi.h)

この関数は、機能名から 2 つの SID 配列を作成します。 1 つは NT Authority を持つ配列グループ SID で、もう 1 つは AppAuthority を持つ機能 SID の配列です。

構文

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

Parameters

[in] CapName

文字列形式の機能の名前。

[out] CapabilityGroupSids

NTAuthority を持つ GroupSids。

[out] CapabilityGroupSidCount

配列内の GroupSid の数。

[out] CapabilitySids

AppAuthority を使用した CapabilitySids。

[out] CapabilitySidCount

AppAuthority を使用した CapabilitySid の数。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、 FALSE が返されます。 拡張エラー情報を取得するには、GetLastError呼び出します。

注釈

呼び出し元は、配列自体に割り当てられたメモリだけでなく、 LocalFreeを呼び出すことによって、各配列で返される個々の SID を解放することが期待されます。

レガシ機能 (Win10 より前に公開) のアプリケーション機能用に計算された SID は、発行済みの SID と同じですが、サービス グループ機能 SID の SID はハッシュ ベースになります。

Requirements

Requirement 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の Windows
ヘッダー securitybaseapi.h (Windows.h を含む)
ライブラリ OneCoreUAP.lib
DLL KernelBase.dll
  • Last updated on