attribut context_handle_serialize

Artikel
06/13/2023

Das [context_handle_serialize] ACF-Attribut garantiert, dass ein Kontexthandle unabhängig vom Standardverhalten der Anwendung immer serialisiert wird.

typedef [context_handle_serialize [ , type-acf-attribute-list ] ] context-handle-type;

[context_handle_serialize [, function-acf-attribute-list ] ] function-name( );

function-name(
    [context_handle_serialize [ , parameter-acf-attribute-list ] ] param-name );

Parameter

type-acf-attribute-list: Alle anderen ACF-Attribute, die für den Typ gelten.
context-handle-type: Der Bezeichner, der den Kontexthandletyp angibt, wie in einer typedef-Deklaration definiert. Dies ist der Typ, der das Attribut [context_handle_serialize] in der IDL-Datei empfängt.
function-acf-attribute-list: Alle zusätzlichen ACF-Attribute, die für die Funktion gelten.
Funktionsname: Der Name der Funktion, wie in der IDL-Datei definiert.
parameter-acf-attribute-list: Alle anderen ACF-Attribute, die für den Parameter gelten.
param-name: Der Name des Parameters, wie in der IDL-Datei definiert.

Bemerkungen

Das Attribut [context_handle_serialize] identifiziert ein Bindungshandle, das Kontext- oder Zustandsinformationen auf dem Server zwischen Remoteprozeduraufrufen verwaltet. Das Attribut kann als IDL-Typedef-Type-Attribut , als Funktionsrückgabetyp-Attribut oder als Parameterattribute angezeigt werden.

Standardmäßig werden Aufrufe von Kontexthandles serialisiert, aber eine Anwendung kann RpcSsDontSerializeContext aufrufen, um dieses Standardverhalten außer Kraft zu setzen. Die Verwendung des [context_handle_serialize] -Attributs in einer ACF-Datei garantiert, dass Aufrufe dieses bestimmten Kontexthandles serialisiert werden, auch wenn die aufrufende Anwendung die Standardserialisierung überschrieben hat. Eine Kontextausführungsroutine ist optional.

Dieses Attribut ist in MIDL Version 5.0 verfügbar.

Windows Server 2003 und Windowsâ XP oder höher: Eine einzelne Schnittstelle kann sowohl serialisierte als auch nicht-nicht-ialisierte Kontexthandles aufnehmen, sodass eine Methode auf einer Schnittstelle ausschließlich auf ein Kontexthandle zugreifen kann (serialisiert), während andere Methoden im freigegebenen Modus auf dieses Kontexthandle zugreifen (nicht-ialisiert). Diese Zugriffsfunktionen sind mit Lese-/Schreibsperrmechanismen vergleichbar. Methoden, die ein serialisiertes Kontexthandle verwenden, sind exklusive Benutzer (Writer), während Methoden, die ein nicht-ialisiertes Kontexthandle verwenden, freigegebene Benutzer (Reader) sind. Methoden, die den Zustand eines Kontexthandles zerstören oder ändern, müssen serialisiert werden. Methoden, die den Zustand eines Kontexthandles nicht ändern, z. B. die Methoden, die einfach aus einem Kontexthandle lesen, können nicht verwendet werden. Beachten Sie, dass Erstellungsmethoden implizit serialisiert werden.

Beispiele

typedef [context_handle_serialize] PCONTEXT_HANDLE_TYPE; 
HRESULT RemoteFunc([context_handle_serialize] pCxHandle);

Weitere Informationen

Anwendungskonfigurationsdatei (Application Configuration File, ACF)
ACF-Attribute
context_handle_noserialize
context_handle
Kontexthandles
RpcSsDontSerializeContext
Heruntergefahrene Serverkontextroutine
Multithreadclients und Kontexthandles
Typedef

Freigeben über