This method maps between names and identifiers of members and parameters.
At a Glance
Header file: | Oaidl.h |
Windows CE versions: | 2.0 and later |
Syntax
HRESULT GetIDsOfNames( OLECHAR FAR* FAR* rgszNames,
unsigned int cNames, MEMBERID FAR* pMemId );
Parameters
rgszNames
Passed-in pointer to an array of names to be mapped.
cNames
Count of the names to be mapped.
pMemId
Caller-allocated array in which name mappings are placed.
Return Values
One of the values described in the following table is returned.
Value | Description |
S_OK | Success. |
STG_E_INSUFFICIENTMEMORY | Out of memory. |
E_OUTOFMEMORY | Out of memory. |
E_INVALIDARG | One or more of the parameters is invalid. |
DISP_E_UNKNOWNNAME | One or more of the names could not be found. |
DISP_E_UNKNOWNLCID | The locale identifier (LCID) could not be found in the OLE DLLs. |
TYPE_E_IOERROR | The function could not write to the file. |
TYPE_E_INVDATAREAD | The function could not read from the file. |
TYPE_E_UNSUPFORMAT | The type library has an older format. |
TYPE_E_INVALIDSTATE | The type library could not be opened. |
TYPE_E_WRONGTYPEKIND | Type mismatch. |
Remarks
The function GetIDsOfNames maps the name of a member (rgszNames[0]) and its parameters (rgszNames[1] ...rgszNames[cNames –1]) to the identifier of the member (rgid[0]), and to the IDs of the specified parameters (rgid[1] ... rgid[cNames –1]). The IDs of parameters are 0 for the first parameter in the member function’s parameter list, 1 for the second, and so on.
If the type description inherits from another type description, this function is recursive to the base type description, if necessary, to find the item with the requested member identifier.