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.