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 物件。

存取權限	Description
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	寫入內容

 

下列許可權專屬於檔案物件。

存取權限	Description
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	寫入檔案屬性

 

下列許可權專屬於目錄物件。

存取權限	Description
ACTRL_DIR_LIST	列出目錄的內容
ACTRL_DIR_CREATE_OBJECT	在目錄中建立子物件 (檔案)
ACTRL_DIR_CREATE_CHILD	建立子目錄
ACTRL_DIR_DELETE_CHILD	刪除子目錄
ACTRL_DIR_TRAVERSE	周遊目錄

 

下列許可權專屬於核心物件。

存取權限	Description
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	直接模擬用戶端

 

下列許可權專屬於印表機物件。

存取權限	Description
ACTRL_PRINT_SADMIN	管理列印伺服器
ACTRL_PRINT_SLIST	列舉列印伺服器
ACTRL_PRINT_PADMIN	管理印表機
ACTRL_PRINT_PUSE	使用印表機
ACTRL_PRINT_JADMIN	管理列印作業

 

下列許可權專屬於服務物件。

存取權限	Description
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	用戶定義控制件

 

下列許可權專屬於登錄物件。

存取權限	Description
ACTRL_REG_QUERY	讀取登錄子機碼
ACTRL_REG_SET	撰寫登錄子機碼
ACTRL_REG_CREATE_CHILD	建立登錄子機碼
ACTRL_REG_LIST	列舉登錄子機碼
ACTRL_REG_NOTIFY	建立登錄通知
ACTRL_REG_LINK	複製符號連結

 

下列許可權專屬於窗口物件。

存取權限	Description
ACTRL_WIN_CLIPBRD	啟用剪貼簿的存取權
ACTRL_WIN_GLOBAL_ATOMS	啟用全域 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