Share via

CBaseDispatch::GetIDsOfNames

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

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