GetSidLengthRequired 関数 (securitybaseapi.h)

GetSidLengthRequired 関数は、指定された数のサブ認証を持つ SID を格納するために必要なバッファーの長さをバイト単位で返します。

構文

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

[in] nSubAuthorityCount

SID 構造体に格納するサブ認証の数を指定します。

戻り値は、 SID 構造体の格納に必要なバッファーの長さ (バイト単位) です。この関数は失敗できません。

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


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