rpcEpUnregister 函式 (rpcdce.h)
RpcEpUnregister 函式會從本機端點對應資料庫移除伺服器地址資訊。
語法
RPC_STATUS RpcEpUnregister(
RPC_IF_HANDLE IfSpec,
RPC_BINDING_VECTOR *BindingVector,
UUID_VECTOR *UuidVector
);
參數
IfSpec
從本機端點對應資料庫取消註冊的介面。
BindingVector
要取消註冊之系結句柄向量的指標。
UuidVector
要取消註冊之物件 UUID 選擇性向量的指標。 伺服器應用程式會建構此向量。 RpcEpUnregister 會取消註冊符合指定 IfSpec 和 BindingVector 參數的所有端點對應資料庫元素,以及物件 UUID (s) 。
Null 參數值表示沒有要取消註冊的物件 UUID。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
沒有系結。 |
|
系結句柄無效。 |
|
這是作業的系結錯誤類型。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
RpcEpUnregister 函式會從本機主機的 endpoint-map 資料庫中移除元素。 只有當伺服器先前已註冊端點,且伺服器想要從端點對應資料庫中移除該地址資訊時,伺服器應用程式才會呼叫此函式。
具體而言, RpcEpUnregister 可讓伺服器應用程式根據介面規格或介面規格 (提供之資源) () 物件 UUI (D,移除自己的端點對應資料庫元素 (伺服器位址) 資訊。
伺服器會呼叫 RpcServerInqBindings 函式,以取得必要的 BindingVector 參數。 若要取消註冊選取的端點,伺服器可以在呼叫此函式之前剪除系結向量。
RpcEpUnregister 會從 IfSpec、 BindingVector 和 UuidVector 參數建立交叉乘積,並從端點對應資料庫移除交叉乘積中的每個元素。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |