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

関連項目

アクセス制御の概要

AllocateAndInitializeSid

基本的なAccess Control関数

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID