AllocateAndInitializeSid 関数 (securitybaseapi.h)

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 を使用します。

例

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

要件

こちらもご覧ください

アクセス制御

基本的なAccess Control関数

FreeSid

GetSidIdentifierAuthority

InitializeSid

SID_IDENTIFIER_AUTHORITY

既知の SID