ISecurityInformation::GetAccessRights メソッド (aclui.h)

[アーティクル]
02/28/2024

GetAccessRights メソッドは、セキュリティ保護可能なオブジェクトに対して制御できるアクセス権に関する情報を要求します。アクセス制御エディターは、このメソッドを呼び出して、プロパティページの初期化に使用される表示文字列やその他の情報を取得します。詳細については、「 Access Rights and Access Masks」を参照してください。

構文

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

パラメーター

[in] pguidObjectType

アクセス権が要求されているオブジェクトの種類を識別する GUID 構造体へのポインター。このパラメーターが NULL またはGUID_NULLへのポインターである場合は、編集するオブジェクトのアクセス権を返します。それ以外の場合、GUID は ISecurityInformation::GetInheritTypes メソッドによって返される子オブジェクト型を識別します。 GUID は、オブジェクト固有の ACE の InheritedObjectType メンバーに対応します。

[in] dwFlags

初期化されるプロパティページを示すビットフラグのセット。基本的なセキュリティページが初期化されている場合、この値は 0 です。それ以外の場合は、次の値の組み合わせになります。

値	意味
SI_ADVANCED	Advanced Security プロパティシートが初期化されています。
SI_EDIT_AUDITS	Advanced Security プロパティシートには、Audit プロパティページが含まれています。
SI_EDIT_PROPERTIES	Advanced Security プロパティシートを使用すると、オブジェクトのプロパティとプロパティセットに適用される ACE を編集できます。

[out] ppAccess

SI_ACCESS構造体の配列へのポインター。配列には、アクセス権ごとに 1 つのエントリが含まれている必要があります。オブジェクト自体に適用されるアクセス権と、オブジェクトのプロパティセットまたはプロパティにのみ適用されるオブジェクト固有のアクセス権を指定できます。

[out] pcAccesses

ppAccess 配列内のエントリの数を示す ULONG へのポインター。

[out] piDefaultAccess

既定のアクセス権を含む配列エントリの 0 から始まるインデックスを示す ULONG へのポインター。アクセス制御エディターは、このエントリを新しい ACE の初期アクセス権として使用します。

戻り値

関数が成功した場合、関数はS_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、「共通 HRESULT 値」を参照してください。

注釈

GetAccessRights メソッドは、プロパティページが初期化されるたびに呼び出されます。

アクセス制御エディターは 、ppAccess で返されるポインターを解放しません。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	aclui.h