IDispatch::GetTypeInfoCount

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

At a Glance

Header file:	Oaidl.h
Windows CE versions:	2.0 and later

Syntax

HRESULT GetTypeInfoCount( unsigned int FAR* pctinfo );

Parameters

pctinfo

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

One of the values described in the following table is returned.

Value	Description
S_OK	Success.
E_NOTIMPL	Failure.

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;
}