kenmerk context_handle_serialize

Het ACF-kenmerk [context_handle_serialize] garandeert dat een contextgreep altijd wordt geserialiseerd, ongeacht het standaardgedrag van de toepassing.

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 );

Parameterwaarden

type-acf-attribute-list

Alle andere ACF-kenmerken die van toepassing zijn op het type.

context-handle-type

De id die het type contexthandler opgeeft, zoals gedefinieerd in een typedef-declaratie . Dit is het type dat het kenmerk [context_handle_serialize] in het IDL-bestand ontvangt.

function-acf-attribute-list

Eventuele aanvullende ACF-kenmerken die van toepassing zijn op de functie.

functienaam

De naam van de functie zoals gedefinieerd in het IDL-bestand.

parameter-acf-attribute-list

Alle andere ACF-kenmerken die van toepassing zijn op de parameter.

parameternaam

De naam van de parameter zoals gedefinieerd in het IDL-bestand.

Opmerkingen

Het kenmerk [context_handle_serialize] identificeert een bindingsgreep die context- of statusinformatie op de server onderhoudt tussen externe procedure-aanroepen. Het kenmerk kan worden weergegeven als een idL-typetypekenmerk , als functie retourtypekenmerk of als parameterkenmerk.

Standaard worden aanroepen van contextgrepen geserialiseerd, maar een toepassing kan RpcSsDontSerializeContext aanroepen om dit standaardgedrag te overschrijven. Als u het kenmerk [context_handle_serialize] in een ACF-bestand gebruikt, wordt gegarandeerd dat aanroepen op deze specifieke contexthandgreep worden geserialiseerd, zelfs als de aanroepende toepassing de standaardserialisatie heeft overschreven. Een contextuitvoeringsroutine is optioneel.

Dit kenmerk is beschikbaar in MIDL versie 5.0.

Windows Server 2003 en Windows XP of hoger: Eén interface kan worden gebruikt voor zowel geserialiseerde als niet-geserialiseerde contextingangen, waardoor één methode op een interface uitsluitend toegang heeft tot een contexthandgreep (geserialiseerd), terwijl andere methoden toegang hebben tot die contextgreep in de gedeelde modus (niet-geserialiseerd). Deze toegangsmogelijkheden zijn vergelijkbaar met vergrendelingsmechanismen voor lezen/schrijven; methoden die gebruikmaken van een geserialiseerde contextingang zijn exclusieve gebruikers (schrijvers), terwijl methoden die gebruikmaken van een niet-geserialiseerde contexthandgreep gedeelde gebruikers (lezers). Methoden die de status van een contextgreep vernietigen of wijzigen, moeten worden geserialiseerd. Methoden die de status van een contextingang niet wijzigen, zoals methoden die gewoon vanuit een contextingang worden gelezen, kunnen niet worden geserialiseerd. Houd er rekening mee dat het maken van methoden impliciet wordt geserialiseerd.

Examples

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

Zie ook

Toepassingsconfiguratiebestand (ACF)

ACF-kenmerken

context_handle_noserialize

context_handle

Contextgrepen

RpcSsDontSerializeContext

Uitvoeringsroutine servercontext

Multithreaded Clients en Context Handles

typedef