RtlGetSaclSecurityDescriptor 関数 (ntifs.h)

[アーティクル]
03/08/2023

RtlGetSaclSecurityDescriptor ルーチンは、セキュリティ記述子のシステム ACL (SACL) へのポインターを返します。

構文

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

パラメーター

[in] SecurityDescriptor

SACL が返される SECURITY_DESCRIPTOR へのポインター。

[out] SaclPresent

指定したセキュリティ記述子に SACL が存在することを示すブール型 (Boolean) の変数へのポインター。この変数が TRUE を受け取る場合、セキュリティ記述子には SACL が含まれており、残りの出力パラメーターは有効な値を受け取ります。この変数が FALSE を受け取った場合、セキュリティ記述子には SACL が含まれていません。残りの出力パラメーターは有効な値を受け取りません。

[out] Sacl

セキュリティ記述子の SACL のアドレスを受け取る変数へのポインター。セキュリティ記述子に SACL がない場合、この変数は値を受け取りません。セキュリティ記述子に NULL SACL がある場合、この変数は NULL を受け取ります。

[out] SaclDefaulted

セキュリティ記述子の SACL が存在する場合、セキュリティ記述子のSECURITY_DESCRIPTOR_CONTROL構造体でSE_SACL_DEFAULTED フラグの値を受け取るブール型 (Boolean) の変数へのポインター。

戻り値

RtlGetSaclSecurityDescriptor は、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_UNKNOWN_REVISION	セキュリティ記述子のリビジョンレベルが不明であるか、サポートされていません。これはエラーコードです。

注釈

セキュリティとアクセス制御の詳細については、ドライバー開発者向けの Windows セキュリティモデルと、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2003 SP1
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL