RpcNsMgmtBindingUnexportA 函式 (rpcnsi.h)
RpcNsMgmtBindingUnexport 函式會從 name-service 資料庫中的專案移除多個系結句柄和物件。
語法
RPC_STATUS RpcNsMgmtBindingUnexportA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_ID *IfId,
unsigned long VersOption,
UUID_VECTOR *ObjectUuidVec
);
參數
EntryNameSyntax
EntryName 的語法。
若要使用登錄值專案 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的語法,請提供 RPC_C_NS_SYNTAX_DEFAULT的值。
EntryName
要從中移除系結句柄和物件 UUID 之專案名稱的指標。
IfId
介面識別的指標。 Null 參數值表示係結句柄不是未導出的,只有物件 UUID 是未導出的。
VersOption
指定 RpcNsMgmtBindingUnexport 函式如何使用 IfId 參數所指向之結構的 VersMajor 和 VersMinor 成員。
下表描述 VersOption 參數的有效值。
ObjectUuidVec
指向伺服器不再想要提供之物件 UUID 的向量指標。 應用程式會建構此向量。 Null 值表示沒有未匯出的物件 UUID,只有系結句柄才會取消匯出。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
版本選項無效。 |
|
名稱語法無效。 |
|
不支援名稱語法。 |
|
名稱不完整。 |
|
找不到名稱服務專案。 |
|
名稱服務無法使用。 |
|
找不到介面。 |
|
並非所有物件都未匯出。 |
備註
RpcNsMgmtBindingUnexport 函式可讓管理應用程式從名稱服務資料庫專案中移除下列其中一項:
- 指定介面 UUID 的所有系結句柄,由介面版本號碼限定, (主要和次要)
- 一或多個資源的物件 UUID
- 系結句柄和資源的物件 UUID
如果找到指定介面的一或多個系結句柄,且未匯出,則 RpcNsMgmtBindingUnexport 會取消導出任何指定的物件 UUID。 如果找不到任何指定的物件 UUID,RpcNsMgmtBindingUnexport 會傳回RPC_S_NOT_ALL_OBJS_UNEXPORTED。
除了呼叫 RpcNsMgmtBindingUnexport 之外,管理應用程式也應該呼叫 RpcMgmtEpUnregister 函式,以取消註冊已向端點對應資料庫註冊的伺服器。
注意
rpcnsi.h 標頭會根據 UNICODE 預處理器常數的定義,將 RpcNsMgmtBindingUnexport 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rpcnsi.h (包含 Rpc.h) |
程式庫 | Rpcns4.lib |
Dll | Rpcns4.dll |