Condividi tramite


Funzione RpcBindingUnbind (rpcasync.h)

La funzione RpcBindingUnbind annulla l'associazione di un handle di associazione precedentemente associato da RpcBindingBind.

Sintassi

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

Parametri

[in] Binding

RPC_BINDING_HANDLE struttura che contiene l'handle di associazione da rimuovere dal server RPC.

Valore restituito

Questa funzione restituisce RPC_S_OK in caso di esito positivo; in caso contrario, viene restituito un codice di errore RPC_S_*.

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

Commenti

RpcBindingUnbind annulla l'associazione di un handle di associazione associato in precedenza da un server RPC. Un handle non associato può essere modificato con chiamate come RpcBindingSetOption e RpcBindingSetAuthInfoEx. Un handle di associazione nello stato non associato può essere di nuovo associato e riutilizzato per effettuare chiamate.

I risultati di un'operazione di associazione non sono definiti se viene chiamato su un handle di associazione che attualmente include chiamate RPC in corso al momento dell'annullamento dell'associazione. È responsabilità del chiamante assicurarsi che nessuna chiamata sia in corso al momento del tentativo di un'operazione di associazione.

Si noti che la chiamata a RpcBindingUnbind non disconnette necessariamente il client dal server. Invaliderà tutte le informazioni memorizzate nella cache usate dall'handle di associazione, ma in realtà non viene garantita la disconnessione. Per garantire la disconnessione, liberare l'handle di associazione con RpcBindingFree.

Windows Vista: Attualmente, questa funzione supporta solo la sequenza di protocollo ncalrpc .

Requisiti

   
Client minimo supportato Windows Vista, Windows XP con SP2 [app desktop | App UWP]
Server minimo supportato Windows Server 2008, Windows Server 2003 con SP1 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione rpcasync.h (include Rpc.h)
Libreria Rpcrt4.lib
DLL Rpcrt4.dll

Vedi anche

RpcBindingBind

RpcBindingFree