AddConditionalAce

指定したアクセス制御リスト (ACL) に条件付きアクセス制御エントリ (ACE) を追加する。

AddConditionalAce pAcl, dwAceRevision, AceFlags, AceType, AccessMask, pSid, ConditionStr, ReturnLength

pAcl : [var] ACL へのポインタ。本関数はこの ACL に ACE を追加する。このパラメータの値を NULL にすることはできない。
dwAceRevision : [int] 変更する ACL のリビジョンレベルを指定する。この値には ACL_REVISION または ACL_REVISION_DS を指定できる。ACL にオブジェクト固有の ACE が含まれる場合は ACL_REVISION_DS を使用する。
AceFlags : [int] ACE の継承を制御するビットフラグのセット。関数はこれらのフラグを AceFlags メンバに設定する。
AceType : [int] ACE の種類。
AccessMask : [int] 指定した SID に許可するアクセス権のマスクを指定する。
pSid : [int] アクセスを許可するユーザー、グループ、またはログオンアカウントを表す SID へのポインタ。
ConditionStr : [wstr] ACE について評価する条件式を指定する文字列。
ReturnLength : [var] ACL のサイズ(バイト単位)。pACL パラメータで指定したバッファが十分なサイズでない場合、このパラメータの値は必要なサイズとなる。

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

解説

指定したアクセス制御リスト (ACL) に条件付きアクセス制御エントリ (ACE) を追加する。

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

情報

プラグイン / モジュールadvapi32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の advapi32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_advapi32_gen2.hs