async-Attribut
Das ACF-Attribut [async] definiert einen Remoteprozeduraufruf als asynchronen Vorgang.
[async, opt-acf-attributes] function-name (param-list)
-
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.
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.
//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