RpcMgmtSetAuthorizationFn 函式會建立授權函式,以處理伺服器管理功能的遠端呼叫。
語法
RPC_STATUS RpcMgmtSetAuthorizationFn(
RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);
參數
AuthorizationFn
指定授權函式。 每當伺服器運行時間收到用戶端要求來執行其中一個遠端管理功能時,RPC 伺服器運行時間連結庫就會自動呼叫此函式。 伺服器必須實作此函式。 應用程式會指定 NULL 值,以取消註冊先前註冊的授權函式。 在這類呼叫之後,會使用默認授權。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
伺服器應用程式會呼叫 RpcMgmtSetAuthorizationFn 函式,以建立可控制伺服器遠端管理功能存取權的授權函式。 當伺服器未呼叫 RpcMgmtSetAuthorizationFn,或以 Null 值呼叫 AuthorizationFn 時,伺服器運行時間連結庫會使用下列預設授權。
| 遠端函式 | 默認授權 |
|---|---|
| RpcMgmtInqIfIds | 啟用 |
| RpcMgmtInqServerPrincName | 啟用 |
| RpcMgmtInqStats | 啟用 |
| RpcMgmtIsServerListening | 啟用 |
| RpcMgmtStopServerListening | 已停用 |
在上表中,「已啟用」表示所有用戶端都可以執行遠端函式,而「已停用」表示所有用戶端都無法執行遠端函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcdce.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |