IDispatch::GetTypeInfoCount

This method retrieves the number of type information interfaces that an object provides, either 0 or 1.

HRESULT GetTypeInfoCount( 
  unsigned int FAR* pctinfo 
);

Parameters

  • pctinfo
    [out] Pointer to a location that receives the number of type information interfaces provided by the object. If the object provides type information, this number is 1; otherwise the number is 0.

Return Values

If the method succeeds, the return value is S_OK.

If the method fails, the return value is E_NOTIMPL.

Remarks

The function may return zero, which indicates that the object does not provide any type information. In this case, the object may still be programmable through IDispatch, but does not provide type information for browsers, compilers, or other programming tools that access type information. This can be useful for hiding an object from browsers or for preventing early binding on an object.

Example

This code from the Lines sample file Lines.cpp implements the GetTypeInfoCount member function for the CLines class (ActiveX or OLE object).

STDMETHODIMP
CLines::GetTypeInfoCount(UINT FAR* pctinfo)
{
*pctinfo = 1;
return NOERROR;
}

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Oaidl.h, Oaidl.idl.
Link Library: Oleaut32.lib, Uuid.lib.

See Also

IDispatch

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.