RpcSsDontSerializeContext-Funktion (rpcdce.h)

  • Artikel

Die RpcSsDontSerializeContext-Funktion deaktiviert die Laufzeitserialisierung mehrerer Aufrufe, die an Server-Manager-Routinen über dasselbe Kontexthandle verteilt werden. Die Verwendung dieser Funktion wird nicht empfohlen. Entwickler sollten stattdessen die Serialisierung im gemischten Modus – Inhaltshandles verwenden. Der Abschnitt Siehe auch enthält Links zu geeigneteren Funktionen.

Syntax

void RpcSsDontSerializeContext();

Rückgabewert

Keine

Bemerkungen

Die RpcSsDontSerializeContext-Funktion verhindert, dass die Laufzeit diesen Serialisierungsdienst ausführt, sodass mehrere Aufrufe für ein bestimmtes Kontexthandle verteilt werden können. Durch den Aufruf dieser Funktion wird die Serialisierung nicht vollständig deaktiviert. Wenn ein Kontext ausfällt, wird Ihre Kontextausführungsroutine erst ausgeführt, wenn alle ausstehenden Clientanforderungen abgeschlossen sind. Änderungen am Status des Kontexthandles, einschließlich der Freigabe des Kontexthandles, müssen weiterhin serialisiert werden.

Wenn Ihre verteilte Anwendung die RpcSsDontSerializeContext-Funktion aufruft , sollte der Aufruf erfolgen, bevor das Serverprogramm mit der Verarbeitung von Remoteprozeduraufrufen beginnt.

Hinweis In der Regel serialisiert die RPC-Laufzeit Aufrufe mit demselben Kontexthandle, das an Server-Manager-Routinen verteilt wird. Kontexthandles werden auf Clientbasis verwaltet und stellen in der Regel den serverseitigen Zustand dar. Dies bedeutet, dass Ihr Server-Manager sich nicht vor einem anderen Thread desselben Clients schützen muss, der den Kontext ändert, oder vor dem Auslaufen des Kontexts, während ein Aufruf ausgeführt wird.
 
Hinweis Nachdem sie aufgerufen wurde, kann die RpcSsDontSerializeContext-Funktion für die Lebensdauer des Prozesses nicht mehr rückgängig machen.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rpcdce.h
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Multithreadclients und Kontexthandles

RpcSsContextLockExclusive

RpcSsContextLockShared

Heruntergefahrene Serverkontextroutine

context_handle_noserialize

context_handle_serialize