ITypeInfo::GetFuncDesc

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the FUNCDESC structure that contains information about a specified function.

Syntax

HRESULT GetFuncDesc( 
  unsigned int index, 
  FUNCDESC FAR* FAR* ppFuncDesc 
);

Parameters

  • index
    [in] Index of the function whose description is to be returned. The index should be in the range of 0 to 1 less than the number of functions in this type.
  • ppFuncDesc
    [out] On return, pointer to a pointer to a FUNCDESC that describes the specified function.

Return Value

The following table shows the return values for this function.

Value Description

S_OK

Success.

E_OUTOFMEMORY

Out of memory.

E_INVALIDARG

One or more of the parameters is invalid.

TYPE_E_IOERROR

The function could not read from the file.

TYPE_E_INVDATAREAD

Invalid data.

TYPE_E_UNSUPFORMAT

The type library has an older format.

TYPE_E_INVALIDSTATE

The type library could not be opened.

Remarks

The function GetFuncDesc provides access to a FUNCDESC structure that describes the function with the specified index. The FUNCDESC should be freed with ITypeInfo::ReleaseFuncDesc. The number of functions in the type is one of the attributes contained in the TYPEATTR structure.

Example

CHECKRESULT(ptypeinfo->GetFuncDesc(i, &pfuncdesc));
idMember = pfuncdesc->elemdescFunc.ID;
CHECKRESULT(ptypeinfo->GetDocumentation(idMember, &bstrName, NULL, NULL, NULL));
ptypeinfo->ReleaseFuncDesc(pfuncdesc);

Requirements

Header oaidl.h, oaidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ITypeInfo
FUNCDESC
ITypeInfo::ReleaseFuncDesc
TYPEATTR