Función RpcBindingFree (rpcdce.h)

Artículo
08/25/2023

La función RpcBindingFree libera recursos de identificador de enlace.

Sintaxis

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parámetros

Binding

Puntero al enlace de servidor que se va a liberar.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_BINDING	El identificador de enlace no era válido.
RPC_S_WRONG_KIND_OF_BINDING	Este era el tipo incorrecto de enlace para la operación.

Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.

Comentarios

La función RpcBindingFree libera la memoria usada por un identificador de enlace de servidor. También se libera información de enlace a la que se hace referencia durante la ejecución del programa. Una aplicación llama a la función RpcBindingFree cuando termina de usar el identificador de enlace. Los identificadores de enlace RPC no deben liberarse hasta que todas las llamadas que usen el identificador se hayan completado; si no lo hace, se producirán resultados imprevisibles.

Los identificadores de enlace se crean dinámicamente mediante una llamada a las siguientes funciones:

Si la operación libera correctamente el enlace, el parámetro Binding devuelve un valor de NULL.

Nota Microsoft RPC solo admite RpcBindingFree en aplicaciones cliente o en aplicaciones de servidor para los identificadores de enlace generados con RpcBindingServerFromClient.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll