Share via

DispGetIDsOfNames

  • Article

This function uses type information to convert a set of names to DISPIDs.

HRESULT DispGetIDsOfNames(
ItypeInfo *ptinfo, 
OLECHAR FAR *FAR *rgszNames, 
unsigned int cNames, 
DISPID FAR *rgdispid );

Parameters

  • ptinfo
    Pointer to the type information for an interface. This type information is specific to one interface and language code, so it is not necessary to pass an interface identifier (IID) or LCID to this function.
  • rgszNames
    Array of name strings that can be the same array passed to DispInvoke in the DISPPARAMS structure. If cNames is greater than 1, the first name is interpreted as a method name, and subsequent names are interpreted as parameters to that method.
  • cNames
    Number of elements in rgszNames.
  • rgdispid
    Pointer to an array of DISPIDs to be filled in by this function. The first identifier corresponds to the method name. Subsequent identifiers are interpreted as parameters to the method.

Return Values

One of the values obtained from the returned HRESULT and described in the following table is returned.

Value Description
S_OK The interface is supported.
E_INVALIDARG One of the arguments is invalid.
DISP_E_UNKNOWNNAME One or more of the given names were not known. The returned array of DISPIDs contains DISPID_UNKNOWN for each entry that corresponds to an unknown name.
Other return codes Any of the ITypeInfo::Invoke errors can also be returned.

Remarks

Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application.

Example

This code from the Lines sample file Points.cpp implements the member function GetIDsOfNames for the CPoints class using DispGetIDsOfNames.

STDMETHODIMP
CPoints::GetIDsOfNames(
    REFIID riid,
    char FAR* FAR* rgszNames,
    UINT cNames,
    LCID lcid,
    DISPID FAR* rgdispid)
{
  return DispGetIDsOfNames(m_ptinfo, rgszNames, cNames, rgdispid);
}

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Oleauto.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.