Main Page   Modules   Class Hierarchy   Compound List   File List   Compound Members   File Members   Related Pages   Examples  

Hyperion Components


Modules

Standard Compounds
Primary Interfaces
Exported Functions
Smart-Pointers

Typedefs

typedef int hypSERVERINFO

Functions

com_result hypGetPathInprocessServer (const CGuid &Guid, std::string &PathInprocess)
com_result GetClassObject (const hypCLSID &clsid, t_ulong ClsContext, hypSERVERINFO *pServerInfo, const hypIID &iid, void **ppv)
com_result CreateInstance (const hypCLSID &clsid, IUnknown *pUnknownOuter, t_ulong ClsContext, const hypIID &iid, void **ppv)
void FreeUnusedLibraries (void)
void GetLoadedLibraries (std::ostream &Stream)

Variables

const t_ulong INPROC_SERVER = 1

Typedef Documentation

typedef int hypSERVERINFO
 

Designed to stock informations about the server. Used only for compatibility with COM.


Function Documentation

com_result CreateInstance ( const hypCLSID & clsid,
IUnknown * pUnknownOuter,
t_ulong ClsContext,
const hypIID & iid,
void ** ppv )
 

Creates an component. The Component Server must implement the IClassFactory interface.

Parameters:
clsid   CLSID of the created component.
pUnknownOuter   Pointer to a component which is used for the aggregation.
ClsContext   Server context. Only INPROC_SERVER is accepted
iid   Selected IID of the created component.
ppv   Pointer on the created component.
Returns:
Result code. If the function fails :
  • The return code is an error code
  • ppv is set to 0

void FreeUnusedLibraries ( void )
 

Frees the unused component servers. If a server is unused, hypDllCanUnloadNow must return a succeeded result code.

com_result GetClassObject ( const hypCLSID & clsid,
t_ulong ClsContext,
hypSERVERINFO * pServerInfo,
const hypIID & iid,
void ** ppv )
 

Gets the pointer to a ClassFactory interface. This pointer is used to create components.

Parameters:
clsid   CLSID of the component that will be created with the use of the interface.
ClsContext   Server context. Only INPROC_SERVER is accepted
pServerInfo   Information about the server. Must be equal to 0
iid   IID of the ClassFactory interface. Usually, the interface is IClassFactory.
ppv   Pointer of the ClassFactory interface.
Returns:
Result code.

void GetLoadedLibraries ( std::ostream & Stream )
 

Displays the loaded servers.

Parameters:
Stream   Output stream used to display the list of loaded servers.

com_result hypGetPathInprocessServer ( const CGuid & Guid,
std::string & PathInprocess )
 

Gets the full path of the inprocess server.

Parameters:
Guid   CLSID of the component which is loacated in the inprocess server.
PathInprocess   Path of the server that is filled by the function
Returns:
Result code. Test with FAILED to check if the result code is a error code.


Variable Documentation

const t_ulong INPROC_SERVER = 1
 

Context parameter for the component server. Only the inprocess servers are implemented. See DCOM for more informations.


Top of Page
written by Pierre Rebours © 2000-2001. Terms of Use.