id-Attribut

Das [id]- Attribut gibt eine DISPID für eine Memberfunktion an (entweder eine Eigenschaft oder eine Methode, in einer Schnittstelle oder Dispinterface).

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

Parameter

id-num

DISPID für die Funktion.

optional-attribute-list

Gibt eine Liste von null oder mehr MIDL-Schnittstellenattributen an.

Rückgabetyp

Gibt den Rückgabetyp der Funktion an.

Funktionsname

Gibt den Namen der Funktion in der IDL-Datei an.

optional-parameter-list

Null oder mehr Funktionsparameter.

Bemerkungen

Verwenden Sie das [id]- Attribut, wenn Sie einer Methode oder Eigenschaft eine Standard-DISPID (z. B. DISPID_VALUE, DISPID_NEWENUM usw.) zuweisen möchten, oder wenn Sie Ihr eigenes IDispatch::Invoke implementieren, anstatt an DispInvoke/ITypeInfo::Invoke zu delegieren.

Wenn Sie das Attribut [id] nicht für eine Schnittstelle verwenden, weist Ihnen der MIDL-Compiler eine DISPID zu. Wenn Sie jedoch eine Dispinterface mithilfe von Eigenschaften und Methoden angeben, müssen Sie eine DISPID für jede Eigenschaft und Methode angeben.

Die ID-Zahl ist ein positiver 32-Bit-Integralwert. Negative IDs sind für die Verwendung durch Automation reserviert.

Beispiele

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

    /* Other interface statements */
}

Weitere Informationen

Schnittstelle

Dispatchschnittstelle

ODL-Dateisyntax

ODL-Dateibeispiel

Generieren einer Typbibliothek mit MIDL