attribut id

  • Article

L’attribut [id] spécifie un DISPID pour une fonction membre (une propriété ou une méthode, dans une interface ou une dispinterface).

[id(id-num) [,optional-attribute-list]] return-type function-name(optional-parameter-list)

Paramètres

id-num

DISPID pour la fonction .

optional-attribute-list

Spécifie une liste de zéro ou plusieurs attributs d’interface MIDL.

type de retour

Spécifie le type de retour de la fonction.

nom de la fonction

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

optional-parameter-list

Zéro ou plusieurs paramètres de fonction.

Notes

Utilisez l’attribut [id] lorsque vous souhaitez affecter un DISPID standard (comme DISPID_VALUE, DISPID_NEWENUM, etc.) à une méthode ou à une propriété, ou lorsque vous implémentez votre propre IDispatch::Invoke au lieu de déléguer à DispInvoke/ITypeInfo::Invoke.

Si vous n’utilisez pas l’attribut [id] sur une interface, le compilateur MIDL vous affectera un DISPID. Toutefois, lorsque vous spécifiez une dispinterface à l’aide de propriétés et de méthodes, vous devez spécifier un DISPID pour chaque propriété et méthode.

L’id-num est une valeur intégrale positive 32 bits. Les ID négatifs sont réservés à l’utilisation par Automation.

Exemples

interface IKnown : IUnknown
{
    properties:
        [id(90), propget, 
         helpstring("A meaningful comment."] long Func1(void);

    /* Other interface statements */
}

Voir aussi

Interface

dispinterface

Syntaxe de fichier ODL

Exemple de fichier ODL

Génération d’une bibliothèque de types avec MIDL