AddScopedPolicyIDAce 関数 (securitybaseapi.h)

AddScopedPolicyIDAce 関数は、システム アクセス制御リスト (SACL) の末尾に SYSTEM_SCOPED_POLICY_ID_ACEアクセス制御エントリ (ACE) を追加します。 SYSTEM_SCOPED_POLICY_ID_ACE 構造体は、リソースに関連付けられる集約型アクセス ポリシー (CAP) を指定し、アクセス チェック時に使用できます。 標準アクセス権のセットは、「Standard Access Rights」トピックで定義されています。

構文

BOOL AddScopedPolicyIDAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceRevision,
  [in]      DWORD AceFlags,
  [in]      DWORD AccessMask,
  [in]      PSID  pSid
);

パラメーター

[in, out] pAcl

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

[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 フラグを指定する必要があります。

このパラメーターには、次の値の組み合わせを指定できます。

[in] AccessMask

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

[in] pSid

リソースに関連付ける集約型アクセス ポリシーを識別する SID (S-1-17-*) へのポインター。

戻り値

関数が成功した場合は、TRUE返されます。

関数が失敗した場合は、FALSE返します。 拡張エラー情報を取得するには、GetLastError呼び出します。

必要条件

関連項目

Standard Access Rights