IDispatch::GetIDsOfNames

[This is preliminary documentation and subject to change.]

Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs, which can be used on subsequent calls to IDispatch::Invoke. The dispatch function DispGetIDsOfNames provides a standard implementation of GetIDsOfNames.

HRESULT GetIDsOfNames(
  REFIID riid,
  OLECHAR FAR* FAR* rgszNames[cNames],
  unsigned int cNames,
  LCID lcid,
  DISPID FAR* rgDispId[cNames]
);
 

Parameters

riid

[in] Reserved for future use. Must be IID_NULL.

rgszNames

[in] Passed-in array of names to be mapped.

cNames

[in] Count of the names to be mapped.

lcid

[in] The locale context in which to interpret the names.

rgDispId

[out] Caller-allocated array, each element of which contains an identifier (ID) corresponding to one of the names passed in the rgszNames array. The first element represents the member name. The subsequent elements represent each of the member's parameters.

Return Value

S_OK

Success.

E_OUTOFMEMORY

Out of memory.

DISP_E_UNKNOWNNAME

One or more of the names were not known. The returned array of DISPIDs contains DISPID_UNKNOWN for each entry that corresponds to an unknown name.

DISP_E_UNKNOWNLCID

The locale identifier (LCID) was not recognized.