IAccessControl::GrantAccessRights メソッド (iaccess.h)

  • [アーティクル]

新しいアクセス権の一覧を、オブジェクトの既存のアクセス権とマージします。

構文

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

パラメーター

[in] pAccessList

オブジェクトのアクセス リストの配列を含む ACTRL_ACCESS 構造体へのポインター。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

新しいアクセス権リストを既存のアクセス権とマージすると、オブジェクトに少なくとも指定されたアクセス権が付与されます。 このマージ プロセスは、古い拒否されたアクセス権の前に新しい拒否されたアクセス権を追加し、既存の許可された権限の前に新しい許可されたアクセス権を追加することで構成されます。 既存の権限は削除されません。

マージの後、オブジェクトのアクセス権は次のように並べ替えられます。

  1. [新しいアクセスが拒否されました]
  2. [古いアクセスが拒否されました]
  3. [新しいアクセス許可]
  4. [古いアクセス許可]
[ACTRL_ACCESS](.. のシステム提供の実装。/accctrl/ns-accctrl-explicit_access_a.md) 構造体を 1 に設定します。 さらに、アクセス エントリ リストがオブジェクト自体に適用されることを示すには、ACTRL_PROPERTY_ENTRYW構造体の lpProperty メンバーが NULL である必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー iaccess.h

こちらもご覧ください

IAccessControl