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 です。 それ以外の場合は、次の値の組み合わせになります。
[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 |