attribut asynchrone

L’attribut ACF [async] définit un appel de procédure distante en tant qu’opération asynchrone.

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

Paramètres

opt-acf-attributes

Spécifie les attributs de configuration d’application facultatifs.

nom de la fonction

Spécifie le nom de la fonction dans le fichier IDL.

param-list

Spécifie une liste de paramètres facultative.

Notes

Cet attribut n’est pas applicable dans les interfaces COM.

Pour déclarer une fonction RPC en tant qu’asynchrone, déclarez d’abord la fonction dans le cadre d’une définition d’interface dans un fichier IDL. Modifiez ensuite cette déclaration de fonction, dans le fichier de configuration de l’application (ACF), en appliquant l’attribut [async]. Notez que la déclaration de fonction n’effectue aucune mention du handle asynchrone et que le handle de liaison est le premier paramètre. L’application de l’attribut [async] dans le fichier ACF génère le code approprié afin que lorsque cette fonction est appelée, le serveur asynchrone s’attend à recevoir un handle asynchrone avant les autres paramètres.

Exemples

//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

Voir aussi

Fichier de configuration d’application (ACF)

RPC asynchrone