Функция RpcBindingFree (rpcdce.h)

Статья
08/25/2023

Функция RpcBindingFree освобождает ресурсы дескриптора привязки.

Синтаксис

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Параметры

Binding

Указатель на освобождаемую привязку сервера.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Недопустимый дескриптор привязки.
RPC_S_WRONG_KIND_OF_BINDING	Это была неправильная привязка для операции.

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

Функция RpcBindingFree освобождает память, используемую дескриптором привязки сервера. Также освобождаются сведения о привязке, которые были динамически созданы во время выполнения программы. Приложение вызывает функцию RpcBindingFree по завершении с помощью дескриптора привязки. Дескрипторы привязки RPC не должны быть освобождены до завершения всех вызовов, использующих этот дескриптор; неспособность сделать это приведет к непредсказуемым результатам.

Дескрипторы привязки создаются динамически путем вызова следующих функций:

Если операция успешно освобождает привязку, параметр Binding возвращает значение NULL.

Примечание Microsoft RPC поддерживает RpcBindingFree только в клиентских приложениях или в серверных приложениях для дескрипторов привязки, созданных с помощью RpcBindingServerFromClient.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll