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 |