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 );
Returns one of the following values:
|E_OUTOFMEMORY||Out of Memory.|
|DISP_E_UNKNOWNNAME||The name was not known.|
|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.|
GetDispID can be used instead of GetIDsOfNames to obtain the DISPID for a given member.
Because IDispatchEx allows the addition and deletion of members, the set of DISPIDs does not remain constant for the lifetime of an object.
The unused riid parameter in IDispatch::GetIDsOfNames has been removed.
BSTR bstrName; DISPID dispid; IDispatch *pdex; // Assign to pdex and bstrName pdex->
GetDispID(bstrName, fdexNameCaseSensitive, &dispid
); // Use dispid