GetSidSubAuthority 関数 (securitybaseapi.h)

GetSidSubAuthority 関数は、セキュリティ識別子 (SID) で指定されたサブ認証へのポインターを返します。サブ認証の値は、相対識別子 (RID) です。

構文

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

[in] pSid

サブ認証へのポインターが返される SID 構造体へのポインター。

この関数は、無効な SID 構造体を処理しません。 IsValidSid 関数を呼び出して、この関数を呼び出す前に SID 構造体が有効であることを確認します。

[in] nSubAuthority

関数が返すアドレスを持つサブ認証配列要素を識別するインデックス値を指定します。関数は、この値に対して検証テストを実行しません。アプリケーションは GetSidSubAuthorityCount 関数を呼び出して、許容される値の範囲を検出できます。

関数が成功した場合、戻り値は指定された SID サブ認証へのポインターです。詳細なエラー情報を得るには、GetLastError を呼び出します。

関数が失敗した場合、戻り値は未定義です。指定した SID 構造体が無効な場合、または nSubAuthority パラメーターで指定されたインデックス値が範囲外の場合、関数は失敗します。

pSid で指定された SID 構造体では、32 ビット RID 値が使用されます。より長い RID 値を必要とするアプリケーションの場合は、 CreateWellKnownSid および関連する関数を使用します。

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