Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This data type is used by IDispatch::Invoketo identify methods, properties, and arguments.

Syntax 

Typedef LONG DISPID;

Remarks

The following table shows the dispatch identifiers (DISPIDs) with special meaning.

DISPID Description

DISPID_VALUE

The default member for the object. This property or method is invoked when an ActiveX client specifies the object name without a property or method.

DISPID_NEWENUM

The _NewEnumproperty. This special, restricted property is required for collection objects. It returns an enumerator object that supports IEnumVARIANT, and should have the restricted attribute specified in Object Description Language.

DISPID_EVALUATE

The Evaluatemethod. This method is implicitly invoked when the ActiveX client encloses the arguments in square brackets. For example, the following two lines are equivalent.

Copy Code 
x.[A1:C1].value =10
x.Evaluate("A1:C1").value = 10

The Evaluatemethod has the DISPID DISPID_EVALUATE.

DISPID_PROPERTYPUT

The parameter that receives the value of an assignment in a PROPERTYPUT.

DISPID_CONSTRUCTOR

The C++ constructor function for the object.

DISPID_DESTRUCTOR

The C++ destructor function for the object.

DISPID_UNKNOWN

The value returned by IDispatch::GetIDsOfNamesto indicate that a member or parameter name was not found.

DISPID_COLLECT

The Collectproperty. You use this property if the method you are calling through Invokeis an accessor function.

The following DISPIDsare reserved:

  • DISPID_Name (800)

  • DISPID_Delete (801)

  • DISPID_Object (802)

  • DISPID_Parent (803)

Requirements

Header oaidl.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also