atrybut context_handle_noserialize

Atrybut [context_handle_noserialize] ACF gwarantuje, że uchwyt kontekstu nigdy nie zostanie serializowany, niezależnie od domyślnego zachowania aplikacji.

typedef [context_handle_noserialize [ , type-acf-attribute-list ] ] context-handle-type

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

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

Parametry

type-acf-attribute-list

Wszystkie inne atrybuty usługi ACF, które mają zastosowanie do typu.

typ-dojścia kontekstu

Identyfikator określający typ uchwytu kontekstu, zgodnie z definicją w deklaracji typedef . Jest to typ, który odbiera atrybut [context_handle] w pliku IDL.

function-acf-attribute-list

Wszelkie dodatkowe atrybuty usługi ACF, które mają zastosowanie do funkcji.

nazwa funkcji

Nazwa funkcji zdefiniowanej w pliku IDL.

parametr-acf-attribute-list

Wszystkie inne atrybuty usługi ACF, które mają zastosowanie do parametru.

param-name

Nazwa parametru zgodnie z definicją w pliku IDL.

Uwagi

Atrybut [context_handle] identyfikuje uchwyt powiązania, który utrzymuje kontekst lub informacje o stanie na serwerze między zdalnymi wywołaniami procedur. Atrybut może być wyświetlany jako atrybut typu IDL typedef , jako atrybut zwracany przez funkcję lub jako atrybut parametru.

Domyślnie wywołania do uchwytów kontekstowych są serializowane. Aplikacja może wywołać metodę RpcSsDontSerializeContext , aby zastąpić to zachowanie domyślne. Użycie atrybutu [context_handle] w pliku ACF gwarantuje, że wywołania tego konkretnego uchwytu kontekstu nie będą serializowane, niezależnie od zachowania aplikacji wywołującej. Zapewnienie procedury uruchamiania kontekstu jest opcjonalne.

Ten atrybut jest dostępny w wersji MIDL w wersji 5.0.

Windows Server 2003 i Windows XP lub nowszych: Pojedynczy interfejs może pomieścić zarówno serializowane, jak i nieserializowane dojścia kontekstu, umożliwiając jednej metodzie w interfejsie dostęp wyłącznie do kontekstu (serializowane), podczas gdy inne metody uzyskują dostęp do tego kontekstu w trybie udostępnionym (nieserializowany). Te możliwości dostępu są porównywalne z mechanizmami blokowania odczytu/zapisu; metody korzystające z zserializowanego uchwytu kontekstu są wyłącznymi użytkownikami (pisarzami), natomiast metody korzystające z nieserializowanego uchwytu kontekstu są współużytkowanymi użytkownikami (czytelnikami). Metody, które niszczą lub modyfikują stan uchwytu kontekstu, muszą być serializowane. Metody, które nie modyfikują stanu uchwytu kontekstu, takie jak metody, które po prostu odczytują z uchwytu kontekstu, mogą być nieserializowane. Należy pamiętać, że metody tworzenia są niejawnie serializowane.

Examples

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

Zobacz także

Atrybuty usługi ACF

context_handle_serialize

context_handle

Dojścia kontekstu

RpcSsDontSerializeContext

Procedury uruchamiania kontekstu serwera

Wielowątkowi klienci i uchwyty kontekstowe

Typedef