GetSecurityDescriptorSacl 関数 (securitybaseapi.h)

[アーティクル]
03/05/2024

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