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

指定したトラスティがオブジェクトまたはプロパティへのアクセス権を持っているかどうかを判断します。

構文

HRESULT IsAccessAllowed(
  [in]  PTRUSTEEW     pTrustee,
  [in]  LPWSTR        lpProperty,
  [in]  ACCESS_RIGHTS AccessRights,
  [out] BOOL          *pfAccessAllowed
);

パラメーター

[in] pTrustee

トラスティ構造体へのポインター。

[in] lpProperty

プロパティの名前。 IAccessControl の COM 実装を使用している場合、このパラメーターは NULL である必要があります。

[in] AccessRights

オブジェクトに対するアクセス権。 IAccessControl の COM 実装を使用している場合、この値は 0 または 1 (COM_RIGHTS_EXECUTE) である必要があります。

[out] pfAccessAllowed

アクセスが許可されているかどうかを示します。

戻り値

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

注釈

IAccessControl (CLSID_DCOMAccessControl) のシステム提供の実装では、IsAccessAllowed は分散 COM 呼び出し中にのみ呼び出すことができます。有効なトラスティ名はクライアントの名前のみです。

次の表に、 IAccessControl のディレクトリ サービスとストレージの実装で使用されるオブジェクト固有のアクセス許可を示します。

次のアクセス許可は DS オブジェクトに固有です。

アクセス許可	説明
ACTRL_DS_OPEN	DS オブジェクトを開く
ACTRL_DS_CREATE_CHILD	子オブジェクトを作成する
ACTRL_DS_DELETE_CHILD	子オブジェクトを削除する
ACTRL_DS_LIST	オブジェクトを列挙する
ACTRL_DS_SELF	トラスティを含むメンバー リストを更新する
ACTRL_DS_READ_PROP	プロパティの読み取り
ACTRL_DS_WRITE_PROP	プロパティの書き込み

 

次のアクセス許可は、ファイル オブジェクトに固有です。

アクセス許可	説明
ACTRL_FILE_READ	ファイルのデータを読み取ります。
ACTRL_FILE_WRITE	ファイルに書き込む
ACTRL_FILE_APPEND	ファイルに追加する
ACTRL_FILE_READ_PROP	ファイル のプロパティまたは拡張属性の読み取り
ACTRL_FILE_WRITE_PROP	ファイルプロパティまたは拡張属性を書き込む
ACTRL_FILE_EXECUTE	ファイルを実行する
ACTRL_FILE_READ_ATTRIB	ファイル属性を読み取る
ACTRL_FILE_WRITE_ATTRIB	ファイル属性を書き込む

 

次のアクセス許可は、ディレクトリ オブジェクトに固有です。

アクセス許可	説明
ACTRL_DIR_LIST	ディレクトリの内容を一覧表示する
ACTRL_DIR_CREATE_OBJECT	ディレクトリに子オブジェクト (ファイル) を作成する
ACTRL_DIR_CREATE_CHILD	サブディレクトリの作成
ACTRL_DIR_DELETE_CHILD	サブディレクトリを削除する
ACTRL_DIR_TRAVERSE	ディレクトリを走査する

 

次のアクセス許可は、カーネル オブジェクトに固有です。

アクセス許可	説明
ACTRL_KERNEL_TERMINATE	プロセスまたはスレッドを終了する
ACTRL_KERNEL_THREAD	スレッドを作成する
ACTRL_KERNEL_VM	アドレス空間操作を実行する
ACTRL_KERNEL_VM_READ	メモリからの読み取り
ACTRL_KERNEL_VM_WRITE	メモリへの書き込み
ACTRL_KERNEL_DUP_HANDLE	ハンドルを複製する
ACTRL_KERNEL_PROCESS	プロセスを作成する
ACTRL_KERNEL_SET_INFO	カーネル オブジェクトの情報または状態を取得する
ACTRL_KERNEL_GET_INFO	カーネル オブジェクトの情報または状態を設定する
ACTRL_KERNEL_CONTROL	カーネル オブジェクトを制御する (スレッドの中断など)
ACTRL_KERNEL_ALERT	カーネル オブジェクトに警告します。
ACTRL_KERNEL_GET_CONTEXT	スレッド コンテキストを取得する
ACTRL_KERNEL_SET_CONTEXT	スレッド コンテキストを設定する
ACTRL_KERNEL_TOKEN	スレッド トークンを設定する
ACTRL_KERNEL_IMPERSONATE	クライアントの偽装
ACTRL_KERNEL_DIMPERSONATE	クライアントを直接偽装する

 

次のアクセス許可は、プリンター オブジェクトに固有です。

アクセス許可	説明
ACTRL_PRINT_SADMIN	プリント サーバーを管理する
ACTRL_PRINT_SLIST	プリント サーバーを列挙する
ACTRL_PRINT_PADMIN	プリンターを管理する
ACTRL_PRINT_PUSE	プリンターを使用する
ACTRL_PRINT_JADMIN	印刷ジョブを管理する

 

次のアクセス許可は、サービス オブジェクトに固有です。

アクセス許可	説明
ACTRL_SVC_GET_INFO	サービスを開始する
ACTRL_SVC_SET_INFO	サービスを停止する
ACTRL_SVC_STATUS	サービスを一時停止する
ACTRL_SVC_LIST	サービスを列挙する
ACTRL_SVC_START	サービスを開始する
ACTRL_SVC_STOP	サービスを停止する
ACTRL_SVC_PAUSE	サービスを一時停止する
ACTRL_SVC_INTERROGATE	サービスに現在の状態のクエリを実行する
ACTRL_SVC_UCONTROL	ユーザー定義コントロール

 

次のアクセス許可は、レジストリ オブジェクトに固有です。

アクセス許可	説明
ACTRL_REG_QUERY	レジストリ サブキーを読み取る
ACTRL_REG_SET	レジストリ サブキーを作成する
ACTRL_REG_CREATE_CHILD	レジストリ サブキーを作成する
ACTRL_REG_LIST	レジストリ サブキーを列挙する
ACTRL_REG_NOTIFY	レジストリ通知を作成する
ACTRL_REG_LINK	シンボリック リンクを作成します

 

次のアクセス許可は、ウィンドウ オブジェクトに固有です。

アクセス許可	説明
ACTRL_WIN_CLIPBRD	クリップボードへのアクセスを有効にする
ACTRL_WIN_GLOBAL_ATOMS	global-atom アクセスを有効にする
ACTRL_WIN_CREATE	デスクトップ アクセスの作成
ACTRL_WIN_LIST_DESK	デスクトップを列挙する
ACTRL_WIN_LIST	ウィンドウ ステーションを列挙する
ACTRL_WIN_READ_ATTRIBS	属性の読み取り
ACTRL_WIN_WRITE_ATTRIBS	属性を書き込む
ACTRL_WIN_SCREEN	画面へのアクセスを有効にする
ACTRL_WIN_EXIT	ExitWindows または ExitWindowsEx を呼び出す

要件

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

こちらもご覧ください

IAccessControl