IControllingUnknown Class Reference

#include <IControllingUnknown.h>

Inheritance diagram for IControllingUnknown:

Public Types
enum	{ kDefaultIID = IID_ICONTROLLINGUNKNOWN }

Public Member Functions
virtual ClassID	GetClass () const =0
virtual ImplementationID	GetImplementationID (IPMUnknown *p) const =0
virtual PMIID	GetInterfaceID (IPMUnknown *p) const =0
virtual uint32	GetRefCount () const =0
virtual IPMUnknown *	GetInterfacePtr (PMIID interfaceID) const =0
virtual IPMUnknown *	GetInterfacePtr (ImplementationID implID) const =0
virtual const IPMPersist *	GetPersist () const =0
virtual void	SwitchExecutionContext ()=0
Public Member Functions inherited from IPMUnknown
virtual IPMUnknown *	QueryInterface (PMIID interfaceID) const =0
virtual void	AddRef () const =0
virtual void	Release () const =0

Detailed Description

This interface is automatically added to every boss class and contains general information about a boss object such as its reference count. The implementation of this interface is a C++ object that "controls" the interface or "bosses" them, hence the term boss.

Member Function Documentation

virtual ClassID IControllingUnknown::GetClass ( ) const

pure virtual

Return the ClassID associated with the object. Generally this can be more conveniently called via ::GetClass(theBoss) in PersistUtils.h

Returns

ClassID of the boss.

Implemented in IClassInfo.

virtual ImplementationID IControllingUnknown::GetImplementationID ( IPMUnknown *  p ) const

pure virtual

Given a pointer to an interface in the boss, return the implementationID of that interface.

Parameters

p	pointer to an interface of the boss

Returns

ImplementationID of the interface

virtual PMIID IControllingUnknown::GetInterfaceID ( IPMUnknown *  p ) const

pure virtual

Given a pointer to an interface in the boss, return the PMIID of that interface.

Parameters

p	pointer to an interface of the boss

Returns

PMIID of the interface

virtual IPMUnknown* IControllingUnknown::GetInterfacePtr ( PMIID  interfaceID ) const

pure virtual

Return a pointer to an interface, if the interface has already been instantiated.

Otherwise, return nil. You shouldn't need to call this. The reference count is not incremented.

Parameters

interfaceID

specifies interface to get

Returns

IPMUnknown* to the interface

virtual IPMUnknown* IControllingUnknown::GetInterfacePtr ( ImplementationID  implID ) const

pure virtual

Convert implementationID to a pointer to that interface.

You shouldn't need to call this.

Parameters

implID

specifies which interface

Returns

IPMUnknown* pointer to the interface

virtual const IPMPersist* IControllingUnknown::GetPersist ( ) const

pure virtual

Convert implementationID to a pointer to that interface.

You shouldn't need to call this.

Parameters

implID

specifies which interface

Returns

IPMUnknown* pointer to the interface

virtual uint32 IControllingUnknown::GetRefCount ( ) const

pure virtual

Return the current refcount.

Returns

int32 refCount