Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method returns a pointer to the ITypeInfointerface for the object's type information. The type information for an object corresponds to the object's coclassentry in a type library.
Syntax
HRESULT GetClassInfo( ITypeInfo** ppTI ); |
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 the ITypeInfo::Releasemethod on the returned interface pointer if this method returns successfully.
Return Value
This method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED.
If the type information was successfully returned, the method returns S_OK.
If the address in ppTIis not valid, the method returns E_POINTER.
Remarks
Notes to Callers
The caller is responsible for calling ITypeInfo::Releasewhen the returned interface pointer is no longer needed.
Notes to Implementers
This method must call ITypeInfo::AddRefbefore returning. If the object loads the type information from a type library, the type library itself will call AddRefin 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.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
Header | ocidl.h, ocidl.idl |
Library | ole32.lib, uuid.lib |
Windows Embedded CE | Windows CE 3.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |