Funzione RpcBindingFree (rpcdce.h)

Articolo
08/25/2023

La funzione RpcBindingFree rilascia le risorse dell'handle di associazione.

Sintassi

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parametri

Binding

Puntatore all'associazione server da liberare.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	Handle di associazione non valido.
RPC_S_WRONG_KIND_OF_BINDING	Si tratta del tipo di binding errato per l'operazione.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

La funzione RpcBindingFree rilascia memoria utilizzata da un handle di associazione server. Vengono rilasciate anche informazioni di associazione di riferimento create in modo dinamico durante l'esecuzione del programma. Un'applicazione chiama la funzione RpcBindingFree al termine dell'uso dell'handle di associazione. Gli handle di associazione RPC non devono essere liberati fino al completamento di tutte le chiamate che usano l'handle; in caso contrario, si verificheranno risultati imprevedibili.

Gli handle di associazione vengono creati dinamicamente chiamando le funzioni seguenti:

Se l'operazione libera correttamente l'associazione, il parametro Binding restituisce un valore NULL.

Nota Microsoft RPC supporta RpcBindingFree solo nelle applicazioni client o nelle applicazioni server per l'associazione di handle generati con RpcBindingServerFromClient.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll