attribut auto_handle

L’attribut ACF [auto_handle] indique au stub d’établir automatiquement la liaison pour une fonction qui n’a pas de paramètre de handle de liaison explicite.

[ 
    auto_handle [, interface-attribute-list] 
] 
interface interface-name
{
    interface-definition
}

Paramètres

interface-attribute-list

Spécifie un ou plusieurs attributs qui s’appliquent à l’interface dans son ensemble, comme le code ou le nocode. Séparez les attributs d’interface avec des virgules.

nom_interface

Spécifie le nom de l’interface.

définition d’interface

Spécifie les instructions IDL qui forment la définition de l’interface.

Notes

L’attribut [auto_handle] apparaît dans l’en-tête d’interface de l’ACF. Il apparaît également dans l’en-tête d’interface du fichier IDL lorsque vous spécifiez le commutateur du compilateur MIDL /app_config.

Lorsque le client appelle une fonction qui utilise une liaison automatique et qu’il n’existe aucune liaison à un serveur, le stub établit automatiquement la liaison. La liaison est réutilisée pour les appels ultérieurs à d’autres fonctions de l’interface qui utilisent la liaison automatique. Le programme d’application cliente n’a pas besoin de déclarer ou d’effectuer un traitement relatif au handle de liaison.

Lorsque le fichier ACF n’est pas présent ou n’inclut pas l’attribut [implicit_handle], le compilateur MIDL utilise [auto_handle] et émet un message d’information. Le compilateur MIDL utilise également [auto_handle], si nécessaire, pour établir la liaison initiale pour un [context_handle].

L’attribut [auto_handle] ne peut se produire que si l’attribut [implicit_handle] ou [explicit_handle] ne se produit pas. L’attribut [auto_handle] peut se produire dans l’en-tête d’interface ACF ou IDL au plus une fois.

Exemples

[
    auto_handle
] 
interface MyInterface 
{ 
    /* Interface definition goes here*/
} 
[
    auto_handle, 
    code
] 
interface MyInterface
{ 
    /* Interface definition goes here*/
}

Voir aussi

Fichier de configuration d’application (ACF)

/app_config

Code

explicit_handle

context_handle

implicit_handle

nocode