Функция RpcBindingUnbind (rpcasync.h)

Функция RpcBindingUnbind отменяет привязку дескриптора привязки, ранее привязанного rpcBindingBind.

Синтаксис

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

Параметры

[in] Binding

RPC_BINDING_HANDLE структуры, содержащей дескриптор привязки для отмены привязки с RPC-сервера.

Возвращаемое значение

Эта функция возвращает RPC_S_OK при успешном выполнении; в противном случае возвращается код ошибки RPC_S_*.

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

 

Комментарии

RpcBindingUnbind отменяет привязку ранее привязанного дескриптора привязки с RPC-сервера. Необвязанный дескриптор можно изменить с помощью таких вызовов , как RpcBindingSetOption и RpcBindingSetAuthInfoEx. Дескриптор привязки в несвязанном состоянии можно снова привязать и повторно использовать для выполнения вызовов.

Результаты операции отмены привязки не определены, если она вызывается для дескриптора привязки, который в настоящее время выполняет вызовы RPC во время отмены привязки. Вызывающий объект отвечает за отсутствие вызовов при попытке операции отмены привязки.

Обратите внимание, что вызов RpcBindingUnbind не обязательно отключает клиент от сервера. Это сделает недействительными все кэшированные сведения, используемые дескриптором привязки, но на самом деле отключение не гарантируется. Чтобы обеспечить отключение, освободите дескриптор привязки с помощью RpcBindingFree.

Windows Vista: В настоящее время эта функция поддерживает только последовательность протокола ncalrpc .

Требования

Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008, Windows Server 2003 с пакетом обновления 1 (SP1) [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	rpcasync.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также раздел

RpcBindingBindd

RpcBindingFree