IProvideClassInfo::GetClassInfo

Returns a pointer to the ITypeInfo interface for the object's type information. The type information for an object corresponds to the object's coclass entry in a type library.

HRESULT GetClassInfo(
  ITypeInfo** ppTI  //Address of output variable that receives the 
                    //ITypeInfo interface pointer
);
 

Parameters

ppTI

[out] Address of ITypeInfo* pointer variable that receives the interface pointer to the object's type information. The caller is responsible for calling ITypeInfo::Release on the returned interface pointer if this method returns successfully.

Return Values

This method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

S_OK

The type information was successfully returned.

E_POINTER

The address in ppTI is not valid. For example, it may be NULL.

Remarks

Notes to Callers

The caller is responsible for calling ITypeInfo::Release when the returned interface pointer is no longer needed.

Notes to Implementers

This method must call ITypeInfo::AddRef before returning. If the object loads the type information from a type library, the type library itself will call AddRef in creating the pointer.

Because the caller cannot specify a locale identifier (LCID) when calling this method, this method must assume the neutral language, that is, LANGID_NEUTRAL, and use this value to determine what locale-specific type information to return.

This method must be implemented; E_NOTIMPL is not an acceptable return value.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.