共用方式為

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_S_OK
 呼叫成功。
RPC_S_NO_BINDINGS
 沒有系結。
RPC_S_INVALID_BINDING
 系結句柄無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤類型。
 
注意 如需有效錯誤碼的清單，請參閱 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

另請參閱

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings