async-Attribut

  • Artikel

Das ACF-Attribut [async] definiert einen Remoteprozeduraufruf als asynchronen Vorgang.

[async, opt-acf-attributes] function-name (param-list)

Parameter

opt-acf-attributes

Gibt optionale Anwendungskonfigurationsattribute an.

Funktionsname

Gibt den Namen der Funktion in der IDL-Datei an.

param-list

Gibt eine optionale Parameterliste an.

Bemerkungen

Dieses Attribut gilt nicht für COM-Schnittstellen.

Um eine RPC-Funktion als asynchron zu deklarieren, deklarieren Sie zuerst die Funktion als Teil einer Schnittstellendefinition in einer IDL-Datei. Ändern Sie dann diese Funktionsdeklaration innerhalb der Anwendungskonfigurationsdatei (Application Configuration File, ACF), indem Sie das Attribut [async] anwenden. Beachten Sie, dass die Funktionsdeklaration keine Erwähnung des asynchronen Handles vornimmt und dass das Bindungshandle der erste Parameter ist. Durch das Anwenden des [async]-Attributs in der ACF-Datei wird der entsprechende Code generiert, sodass der asynchrone Server beim Aufruf dieser Funktion erwartet, dass vor den anderen Parametern ein asynchrones Handle empfangen wird.

Hinweis

Das async-Attribut kann nicht mit dem Befehlszeilenschalter /osf verwendet werden.

 

Beispiele

//file:Xasync.idl
interface AsyncIface 
{
    HRESULT MyAsyncFunc (
        handle_t hBinding,
        [in] int a,
        [in] int b,
        [out] int *c) ;
//other interface definitions
}
//end XAsync.idl

// file: Xasync.acf
interface AsyncIface
{
    [async] MyAsyncFunc () ;
    //any other ACF definitions
}
//end Xasync.acf

Weitere Informationen

Anwendungskonfigurationsdatei (Application Configuration File, ACF)

Asynchroner RPC