attribut implicit_handle
L’attribut ACF [implicit_handle] spécifie le handle utilisé pour les fonctions qui n’incluent pas de handle explicite en tant que paramètre de procédure.
implicit_handle(handle-type handle-name)
Paramètres
-
handle-type
-
Spécifie le type de données handle, tel que le type de base handle_t ou un type de handle défini par l’utilisateur.
-
handle-name
-
Spécifie le nom du handle.
Notes
Le handle spécifié par l’attribut [implicit_handle] est utilisé de différentes manières selon la nature de la procédure. Si la procédure est distante, le handle est utilisé comme handle de liaison pour l’appel distant. Le handle implicite peut également être utilisé pour établir une liaison initiale pour une fonction qui utilise un handle de contexte. Si la procédure est une procédure de sérialisation, le handle est utilisé comme handle de sérialisation contrôlant l’opération. Dans le cas de la sérialisation de type, le handle est utilisé comme handle de sérialisation pour tous les types sérialisés.
L’attribut [implicit_handle] spécifie une variable globale qui contient un handle utilisé par toute fonction nécessitant des handles implicites.
Le type de handle de liaison implicite doit être handle_t (ou un type basé sur handle_t) ou un type de handle défini par l’utilisateur spécifié avec l’attribut handle . Le handle de sérialisation implicite doit être un type basé sur handle_t.
Si le type de handle implicite n’est pas défini dans le fichier IDL ou dans les fichiers inclus et importés par le fichier IDL de l’ordinateur MIDL, vous devez fournir le fichier contenant la définition de type handle lorsque vous compilez les stubs. Utilisez l’instruction ACF include pour inclure le fichier contenant la définition de type handle.
L’attribut [implicit_handle] peut se produire une seule fois, au plus. L’attribut [implicit_handle] ne peut se produire que si les attributs [auto_handle] et [explicit_handle] ne se produisent pas.
Exemples
/* ACF file */
[
implicit_handle(handle_t hMyHandle)
]
interface iface
{
// Attribute configuration statements
}
Voir aussi