Funzione RpcSsDestroyClientContext (rpcndr.h)

  • Articolo

La funzione RpcSsDestroyClientContext elimina un handle di contesto non più necessario dal client, senza contattare il server.

Sintassi

void RpcSsDestroyClientContext(
  void **ContextHandle
);

Parametri

ContextHandle

Handle di contesto da eliminare. L'handle è impostato su NULL prima che RpcSsDestroyClientContext restituisca.

Valore restituito

RpcSsDestroyClientContext non ha alcun valore restituito.

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

Commenti

RpcSsDestroyClientContext viene usato dall'applicazione client per recuperare le risorse di memoria usate per mantenere un handle di contesto nel client. Questa funzione viene usata quando ContextHandle non è più valida, ad esempio quando si è verificato un errore di comunicazione e il server non è più disponibile. L'handle di contesto è impostato su NULL. La funzione RpcSsDestroyClientContext fornisce la stessa funzionalità della funzione RpcSmDestroyClientContext . Questa funzione non richiama il processo di run-down dell'handle di contesto del server.

Non usare RpcSsDestroyClientContext per sostituire una funzione server che chiude l'handle di contesto.

La funzione RpcSsDestroyClientContext può generare un'eccezione RPC_X_SS_CONTEXT_MISMATCH se l'handle di contesto passato non è valido. Le applicazioni non devono mai passare un handle di contesto non valido a questa funzione. Se viene generata un'eccezione, indica un errore nel codice chiamante e deve quindi essere analizzato e risolto.

Requisiti

Requisito Valore
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 rpcndr.h (include Rpc.h)
Libreria Rpcrt4.lib
DLL Rpcrt4.dll

Vedi anche

RpcBindingReset

RpcSmDestroyClientContext