IDispatch_GetIDsOfNames(3w)

Usage

static HRESULT IDispatch_GetIDsOfNames
(
LPDISPATCH iface,
REFIID riid,
LPOLESTR* rgszNames,
UINT cNames,
LCID lcid,
DISPID* rgDispId
)

Overview

Convert a methods name and an optional set of parameter names into DISPIDs for passing to IDispatch_Invoke(3w).

Params

iface [In] IDispatch interface.

riid [In] Reserved, set to IID_NULL.

rgszNames [In] Name to convert.

cNames [In] Number of names in rgszNames.

lcid [In] Locale of the type information to convert from.

rgDispId [Out] Destination for converted DISPIDs.

Returns

Success: S_OK.

Failure: DISP_E_UNKNOWNNAME, if any of the names is invalid. DISP_E_UNKNOWNLCID if lcid is invalid. Otherwise, an HRESULT error code.

Notes

This call defers to ITypeInfo_GetIDsOfNames(3w), using the ITypeInfo object contained within the IDispatch object. The first member of the names list must be a method name. The names following the method name are the parameters for that method.

Implementation

Declared in "oaidl.h".

Implemented in "dlls/oleaut32/dispatch.c".

Debug channel "ole".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.