GetSidSubAuthorityCount 関数 (securitybaseapi.h)

GetSidSubAuthorityCount 関数は、サブ認証数を含むセキュリティ識別子 (SID) 構造体のメンバーへのポインターを返します。

構文

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

[in] pSid

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

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

関数が成功した場合、戻り値は、指定された SID 構造体のサブ認証数へのポインターです。

関数が失敗した場合、戻り値は未定義です。指定した SID 構造体が無効な場合、関数は失敗します。詳細なエラー情報を得るには、GetLastError を呼び出します。

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

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