InitializeSecurityDescriptor 関数 (securitybaseapi.h)

InitializeSecurityDescriptor 関数は、新しいセキュリティ記述子を初期化します。

構文

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

パラメーター

[out] pSecurityDescriptor

関数が初期化する SECURITY_DESCRIPTOR 構造体へのポインター。

[in] dwRevision

セキュリティ記述子に割り当てるリビジョン レベル。 このパラメーターはSECURITY_DESCRIPTOR_REVISIONする必要があります。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

InitializeSecurityDescriptor 関数は、自己相対形式ではなく、絶対形式でセキュリティ記述子を初期化します。

InitializeSecurityDescriptor 関数は、システム アクセス制御リスト (SACL)、随意アクセス制御リスト (DACL)、所有者なし、プライマリ グループなし、およびすべての制御フラグが FALSE (NULL) に設定されていないセキュリティ記述子を初期化します。 したがって、リビジョン レベルを除き、空です。

この関数を使用する例については、「 新しいオブジェクトのセキュリティ記述子の作成」を参照してください。

要件

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

関連項目

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

低レベルのAccess Control

低レベルのAccess Control関数

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl