Freigeben über


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.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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

Weitere Informationen

RpcBindingReset

RpcSmDestroyClientContext