CBaseDispatch::GetIDsOfNames
A version of this page is also available for
4/8/2010
Maps a single member function and an optional set of parameters to a corresponding set of integer dispatch identifiers, which can be used upon subsequent calls to the IDispatch::Invoke method.
Syntax
HRESULT GetIDsOfNames(
REFIID riid,
OLECHAR** rgszNames,
UINT cNames,
LCID lcid,
DISPID* rgdispid
);
Parameters
- riid
Reference identifier. Reserved for future use. Must be NULL.
- rgszNames
Passed-in array of names to be mapped.
- cNames
Count of the names to be mapped.
- lcid
Local context in which to interpret the names.
rgdispid
Caller-allocated array, each element of which contains an identifier that corresponds to one of the names passed in the rgszNames parameter.The first element represents the member name; subsequent elements represent each of the member's parameters.
Return Value
Returns one of the following values.
| Value | Description |
|---|---|
S_OK |
Success. |
E_OUTOFMEMORY |
Out of memory. |
DISP_E_UNKNOWNNAME |
One or more of the names were not known. The returned DISPIDs contain DISPID_UNKNOWN for each entry that corresponds to an unknown name. |
DISP_E_UNKNOWN_CLSID |
The class identifier was not recognized. |
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |