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 |