GetSecurityDescriptorSacl 関数 (securitybaseapi.h)
GetSecurityDescriptorSacl 関数は、指定されたセキュリティ記述子内のシステム アクセス制御リスト (SACL) へのポインターを取得します。
構文
BOOL GetSecurityDescriptorSacl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] LPBOOL lpbSaclPresent,
[out] PACL *pSacl,
[out] LPBOOL lpbSaclDefaulted
);
パラメーター
[in] pSecurityDescriptor
関数がポインターを取得する SACL を含む SECURITY_DESCRIPTOR 構造体へのポインター。
[out] lpbSaclPresent
指定したセキュリティ記述子に SACL が存在することを示すために関数が設定するフラグへのポインター。 このパラメーターが TRUE の場合、セキュリティ記述子には SACL が含まれており、この関数の残りの出力パラメーターは有効な値を受け取ります。 このパラメーターが FALSE の場合、セキュリティ記述子には SACL が含まれていません。残りの出力パラメーターは有効な値を受け取りません。
[out] pSacl
アクセス制御リスト (ACL) へのポインターへのポインター。 SACL が存在する場合、 関数は pSacl が指すポインターをセキュリティ記述子の SACL のアドレスに設定します。 SACL が存在しない場合、値は格納されません。
関数が pSacl が指すポインターに NULL 値を格納する場合、セキュリティ記述子には NULL SACL があります。
[out] lpbSaclDefaulted
セキュリティ記述子に SACL が存在する場合、SECURITY_DESCRIPTOR_CONTROL構造体の SE_SACL_DEFAULTED フラグの値に設定されるフラグへのポインター。
戻り値
関数が成功した場合、関数は 0 以外の値を返します。
関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | securitybaseapi.h (Windows.h を含む) |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |