AddAuditAccessAce

システムアクセス制御リスト (ACL) にシステム監査アクセス制御エントリ (ACE) を追加する。指定したセキュリティ識別子 (SID) のアクセスが監査される。

AddAuditAccessAce pAcl, dwAceRevision, dwAccessMask, pSid, bAuditSuccess, bAuditFailure

pAcl : [var] ACL へのポインタ。本関数はこの ACL にシステム監査 ACE を追加する。ACE は SYSTEM_AUDIT_ACE 構造体の形式で格納される。
dwAceRevision : [int] 変更する ACL のリビジョンレベルを指定する。
dwAccessMask : [int] 指定した SID について監査するアクセス権のマスクを指定する。
pSid : [int] アクセスが監査されるプロセスを表す SID へのポインタ。
bAuditSuccess : [int] 成功したアクセス試行を監査するかどうかを指定する。監査を有効にするにはこのフラグを TRUE に、そうでなければ FALSE に設定する。
bAuditFailure : [int] 失敗したアクセス試行を監査するかどうかを指定する。監査を有効にするにはこのフラグを TRUE に、そうでなければ FALSE に設定する。

(プラグイン / モジュール : advapi32.dll)

解説

システムアクセス制御リスト (ACL) にシステム監査アクセス制御エントリ (ACE) を追加する。指定したセキュリティ識別子 (SID)
のアクセスが監査される。

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。以下のエラー値が返される可能性がある。
（以下省略）

[備考]
AddAuditAccessAce 関数が ACE に配置する ACE_HEADER 構造体は、種類とサイズを指定するが、ACE
フラグは設定しない。

情報