GetSecurityDescriptorLength 関数 (securitybaseapi.h)

GetSecurityDescriptorLength 関数は、構造的に有効なセキュリティ記述子の長さをバイト単位で返します。長さには、関連付けられているすべての構造体の長さが含まれます。

構文

DWORD GetSecurityDescriptorLength(
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

[in] pSecurityDescriptor

関数が返す長さを持つ SECURITY_DESCRIPTOR 構造体へのポインター。ポインターは有効であると見なされます。

関数が成功した場合、関数は SECURITY_DESCRIPTOR 構造体の長さをバイト単位で返します。

SECURITY_DESCRIPTOR構造体が無効な場合、戻り値は未定義です。

セキュリティ記述子の最小長はSECURITY_DESCRIPTOR_MIN_LENGTH。この長さのセキュリティ記述子には、関連付けられたセキュリティ識別子 (SID) またはアクセス制御リスト (ACL) がありません。

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