AddResourceAttributeAce

システムアクセス制御リスト (SACL) の末尾に SYSTEM_RESOURCE_ATTRIBUTE_ACE アクセス制御エントリ (ACE) を追加する。

AddResourceAttributeAce pAcl, dwAceRevision, AceFlags, AccessMask, pSid, pAttributeInfo, pReturnLength

pAcl : [var] アクセス制御リスト (ACL) へのポインタ。この関数は ACL に ACE を追加する。このパラメータの値は NULL にできない。ACE は SYSTEM_RESOURCE_ATTRIBUTE_ACE 構造体の形式をとる。
dwAceRevision : [int] 変更対象の ACL のリビジョンレベルを指定する。この値は ACL_REVISION または ACL_REVISION_DS が指定できる。ACL にオブジェクト固有の ACE が含まれる場合は ACL_REVISION_DS を使用する。
AceFlags : [int] ACE の継承を制御するビットフラグのセット。この関数は新しい ACE の ACE_HEADER 構造体の AceFlags メンバーにこれらのフラグを設定する。Windows 8 の高度なファイル権限 UI との整合性のため、アプリケーションは AceFlags パラメータに CONTAINER_INHERIT_ACE と OBJECT_INHERIT_ACE を指定する必要がある。
AccessMask : [int] Windows 8 および Windows Server 2012 ではゼロでなければならない。
pSid : [int] Windows 8 および Windows Server 2012 では Everyone SID (S-1-1-0) でなければならない。
pAttributeInfo : [var] ACE の SID の後に付加される属性情報を指定する。
pReturnLength : [var] 実際に使用された ACL バッファのサイズ(バイト単位)。pAcl パラメータで指定したバッファが十分でない場合、このパラメータの値は必要な ACL バッファの合計サイズを示す。

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

解説

システムアクセス制御リスト (SACL) の末尾に SYSTEM_RESOURCE_ATTRIBUTE_ACE アクセス制御エントリ
(ACE) を追加する。

[戻り値]
関数が成功した場合、TRUE を返す。関数が失敗した場合、FALSE を返す。拡張エラー情報を取得するには GetLastError
を呼ぶ。

情報

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