Função RpcBindingFree (rpcdce.h)

Artigo
08/25/2023

A função RpcBindingFree libera recursos de identificador de associação.

Sintaxe

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parâmetros

Binding

Ponteiro para a associação do servidor a ser liberada.

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING	O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING	Esse foi o tipo errado de associação para a operação.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

A função RpcBindingFree libera memória usada por um identificador de associação de servidor. As informações de associação referenciadas que foram criadas dinamicamente durante a execução do programa também são lançadas. Um aplicativo chama a função RpcBindingFree quando termina de usar o identificador de associação. Os identificadores de associação RPC não devem ser liberados até que todas as chamadas que usam o identificador tenham sido concluídas; A falha em fazê-lo causará resultados imprevisíveis.

Os identificadores de associação são criados dinamicamente chamando as seguintes funções:

Se a operação liberar a associação com êxito, o parâmetro Binding retornará um valor NULL.

Nota O Microsoft RPC dá suporte a RpcBindingFree somente em aplicativos cliente ou em aplicativos de servidor para identificadores de associação gerados com RpcBindingServerFromClient.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll