Funzione RpcSsDestroyClientContext (rpcndr.h)
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.
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 |