AddResourceAttributeAce 関数 (securitybaseapi.h)

AddResourceAttributeAce 関数は、SYSTEM_RESOURCE_ATTRIBUTE_ACEアクセス制御エントリ (ACE) をシステム アクセス制御リスト (SACL) の末尾に追加します。 SYSTEM_RESOURCE_ATTRIBUTE_ACE構造体は、リソースに関連付けられている要素の属性名と値順リストを指定し、アクセス チェック中に使用される可能性があります。 標準アクセス権のセットは、「 Standard Access Rights 」トピックで定義されています。

構文

BOOL AddResourceAttributeAce(
  [in, out] PACL                                   pAcl,
  [in]      DWORD                                  dwAceRevision,
  [in]      DWORD                                  AceFlags,
  [in]      DWORD                                  AccessMask,
  [in]      PSID                                   pSid,
  [in]      PCLAIM_SECURITY_ATTRIBUTES_INFORMATION pAttributeInfo,
  [out]     PDWORD                                 pReturnLength
);

パラメーター

[in, out] pAcl

アクセス制御リスト (ACL) へのポインター。 この関数は、この ACL に ACE を追加します。 このパラメーターの値を NULL にすることはできません。 ACE は、 SYSTEM_RESOURCE_ATTRIBUTE_ACE 構造の形式です。

[in] dwAceRevision

変更する ACL のリビジョン レベルを指定します。 この値は、ACL_REVISIONまたはACL_REVISION_DSできます。 ACL にオブジェクト固有の ACE が含まれている場合は、ACL_REVISION_DSを使用します。

[in] AceFlags

ACE 継承を制御するビット フラグのセット。 この関数は、新しい ACE のACE_HEADER構造体の AceFlags メンバーにこれらのフラグを設定します。

Windows 8 Advanced File Permissions UI との整合性を保つには、アプリケーションで AceFlags パラメーターにCONTAINER_INHERIT_ACEフラグとOBJECT_INHERIT_ACE フラグを指定する必要があります。

このパラメーターは、次の値と組み合わせて使用できます。

値	意味
CONTAINER_INHERIT_ACE 2 (0x2)	ACE はコンテナー オブジェクトによって継承されます。
INHERIT_ONLY_ACE 8 (0x8)	ACE は ACE が割り当てられているオブジェクトには適用されませんが、子オブジェクトによって継承できます。
INHERITED_ACE 16 (0x10)	継承された ACE を示します。 このフラグを使用すると、オブジェクトのツリーのセキュリティを変更する操作で、オブジェクトに直接適用された ACE を変更せず、継承された ACE を変更できます。
NO_PROPAGATE_INHERIT_ACE 4 (0x4)	OBJECT_INHERIT_ACEビットとCONTAINER_INHERIT_ACE ビットは、継承された ACE には反映されません。
OBJECT_INHERIT_ACE 1 (0x1)	ACE は、コンテナー以外のオブジェクトによって継承されます。

[in] AccessMask

Windows 8とWindows Server 2012の場合は 0 にする必要があります。

[in] pSid

Windows 8とWindows Server 2012の Everyone SID (S-1-1-0) である必要があります。

[in] pAttributeInfo

ACE の SID の後に追加される属性情報を指定します。

[out] pReturnLength

使用される実際の ACL バッファーのサイズ (バイト単位)。 pAcl パラメーターで指定されたバッファーの大きさが十分でない場合、このパラメーターの値は ACL バッファーに必要な合計サイズです。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、 FALSE が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	securitybaseapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

Standard Access Rights