次の方法で共有


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

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

こちらもご覧ください

Access Control エディター

Access Control エディター関数

CreateSecurityPage

EditSecurity

GUID

ISecurityInformation

ISecurityInformation::GetInheritTypes

SI_ACCESS