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

//Indirect pointer to object’s type information

);

Parameters

ppTI: [out] Indirect pointer to object’s type information. The caller is responsible for calling ITypeInfo::Release on the returned 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.

ITypeInfo** ppTI	//Indirect pointer to object’s type information
);