AllocateAndInitializeSid 関数 (securitybaseapi.h)

[アーティクル]
08/25/2023

AllocateAndInitializeSid 関数は、最大 8 つのサブ認証を使用してセキュリティ識別子 (SID) を割り当てて初期化します。

構文

BOOL AllocateAndInitializeSid(
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount,
  [in]  DWORD                     nSubAuthority0,
  [in]  DWORD                     nSubAuthority1,
  [in]  DWORD                     nSubAuthority2,
  [in]  DWORD                     nSubAuthority3,
  [in]  DWORD                     nSubAuthority4,
  [in]  DWORD                     nSubAuthority5,
  [in]  DWORD                     nSubAuthority6,
  [in]  DWORD                     nSubAuthority7,
  [out] PSID                      *pSid
);

パラメーター

[in] pIdentifierAuthority

SID_IDENTIFIER_AUTHORITY構造体へのポインター。この構造体は、SID で設定する最上位の識別子機関の値を提供します。

[in] nSubAuthorityCount

SID に配置するサブ認証の数を指定します。このパラメーターは、意味のある値を持つサブ認証パラメーターの数も識別します。このパラメーターには、1 ~ 8 の値を含める必要があります。

たとえば、値 3 は、dwSubAuthority0、dwSubAuthority1、および dwSubAuthority2 パラメーターで指定されたサブ認証値に意味のある値があり、剰余を無視することを示します。

[in] nSubAuthority0

SID に配置するサブ認証値。

[in] nSubAuthority1

SID に配置するサブ認証値。

[in] nSubAuthority2

SID に配置するサブ認証値。

[in] nSubAuthority3

SID に配置するサブ認証値。

[in] nSubAuthority4

SID に配置するサブ認証値。

[in] nSubAuthority5

SID に配置するサブ認証値。

[in] nSubAuthority6

SID に配置するサブ認証値。

[in] nSubAuthority7

SID に配置するサブ認証値。

[out] pSid

割り当てられた初期化された SID 構造体へのポインターを受け取る変数へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

AllocateAndInitializeSid 関数で割り当てられた SID は、FreeSid 関数を使用して解放する必要があります。

この関数は、32 ビット RID 値を持つ SID を作成します。より長い RID 値を必要とするアプリケーションの場合は、 CreateWellKnownSid を使用します。

例

この関数を使用する例については、「新しいオブジェクトのセキュリティ記述子の作成」または「オブジェクトの所有権の取得」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	securitybaseapi.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll