RpcSsDestroyClientContext-Funktion (rpcndr.h)
Die RpcSsDestroyClientContext-Funktion zerstört ein Kontexthandle, das vom Client nicht mehr benötigt wird, ohne den Server zu kontaktieren.
Syntax
void RpcSsDestroyClientContext(
void **ContextHandle
);
Parameter
ContextHandle
Zu zerstörende Kontexthandle. Das Handle wird auf NULL festgelegt, bevor RpcSsDestroyClientContext zurückgegeben wird.
Rückgabewert
RpcSsDestroyClientContext hat keinen Rückgabewert.
Hinweise
RpcSsDestroyClientContext wird von der Clientanwendung verwendet, um die Speicherressourcen zurückzugeben, die zum Verwalten eines Kontexthandles auf dem Client verwendet werden. Diese Funktion wird verwendet, wenn ContextHandle nicht mehr gültig ist, z. B. wenn ein Kommunikationsfehler aufgetreten ist und der Server nicht mehr verfügbar ist. Das Kontexthandle ist auf NULL festgelegt. Die RpcSsDestroyClientContext-Funktion bietet die gleiche Funktionalität wie die RpcSmDestroyClientContext-Funktion . Diese Funktion ruft den Herunterlaufprozess des Kontexthandles des Servers nicht auf.
Verwenden Sie rpcSsDestroyClientContext nicht, um eine Serverfunktion zu ersetzen, die das Kontexthandle schließt.
Die RpcSsDestroyClientContext-Funktion kann eine RPC_X_SS_CONTEXT_MISMATCH Ausnahme auslösen, wenn das an sie übergebene Kontexthandle ungültig ist. Anwendungen sollten niemals ein ungültiges Kontexthandle an diese Funktion übergeben. Wenn eine Ausnahme ausgelöst wird, weist dies auf einen Fehler im aufrufenden Code hin und sollte daher untersucht und behoben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcndr.h (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |