Maps a single member name to its corresponding DISPID, which can then be used on subsequent calls to IDispatchEx::InvokeEx.

 HRESULT GetDispID(
   BSTR bstrName,
   DWORD grfdex,
   DISPID *pid
);

Parameters

bstrName

Passed in name to be mapped.

grfdex

Determines the options for obtaining the member identifier. This can be a combination of the following values:

Value	Meaning
fdexNameCaseSensitive	Requests that the name lookup be done in a case-sensitive manner. May be ignored by object that does not support case-sensitive lookup.
fdexNameEnsure	Requests that the member be created if it does not already exist. The new member should be created with the value VT_EMPTY.
fdexNameImplicit	Indicates that the caller is searching object(s) for a member of a particular name when the base object is not explicitly specified.
fdexNameCaseInsensitive	Requests that the name lookup be done in a case-insensitive manner. May be ignored by object that does not support case-insensitive lookup.

pid

Pointer to caller-allocated location to receive DISPID result. If an error occurs, pid contains DISPID_UNKNOWN.

Return Value

Remarks

Example

	Copy Code
BSTR bstrName; DISPID dispid; IDispatchEx *pdex; // Assign to pdex and bstrName pdex->GetDispID(bstrName, fdexNameCaseSensitive, &dispid); // Use dispid

See Also