STLSoft - ... Robust, Lightweight, Cross-platform, Template Software ... ATLSTL - Template Software for the Active Template Library COMSTL - The Standard Template Library meets the Component Object Model .netSTL - Standard Template Library meets the Microsoft.NET Common Language Runtime InetSTL - The Standard Template Library meets WinInet MFCSTL - Template Software for the Microsoft Foundation Classes UNIXSTL - Template Software for the UNIX Operating System WinSTL - where the Standard Template Library meets the Win32 API
Main Page   Modules   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

Running Object Table (ROT) Functions
[COMSTL]

These functions create, manipulate and destroy instances of COM's Running Object Table (ROT). More...

Functions

HRESULT Rot_Register (DWORD grfFlags, LPUNKNOWN punkObject, LPMONIKER pmkObjectName, DWORD *pdwRegister)
 Registers an object in the Running Object Table.

HRESULT Rot_Revoke (DWORD dwRegister)
 Removes an object from the Running Object Table.

HRESULT Rot_IsRunning (LPMONIKER pmkObjectName)
 Determines if object current in the Running Object Table.

HRESULT Rot_GetObject (LPMONIKER pmkObjectName, LPUNKNOWN *ppunkObject)
 Retrieves the object from the Running Object Table.

HRESULT Rot_NoteChangeTime (DWORD dwRegister, FILETIME *lpfiletime)
 Retrieves the last modification time of a running object in the Running Object Table.

HRESULT Rot_GetTimeOfLastChange (LPMONIKER pmkObjectName, FILETIME *lpfiletime)
 Retrieves the last modification time of an object in the Running Object Table.

HRESULT Rot_EnumRunning (IEnumMoniker **ppenumMoniker)
 Queries the current set of objects in the Running Object Table.

Detailed Description

These functions create, manipulate and destroy instances of COM's Running Object Table (ROT).

Function Documentation

HRESULT Rot_EnumRunning (  IEnumMoniker **    ppenumMoniker )  [inline]
 

Queries the current set of objects in the Running Object Table.

Creates and returns a pointer to an enumerator that can list the monikers of all the objects currently registered in the Running Object Table (ROT).

Parameters:
ppenumMoniker  Address of output variable that receives the IEnumMoniker interface pointer
Returns:
An HRESULT indicating success or failure

HRESULT Rot_GetObject (  LPMONIKER    pmkObjectName,
LPUNKNOWN *    ppunkObject
)  [inline]
 

Retrieves the object from the Running Object Table.

Determines whether the object identified by the specified moniker is running, and if it is, retrieves a pointer to that object. This method looks for the moniker in the Running Object Table (ROT), and retrieves the pointer registered there.

Parameters:
pmkObjectName  Pointer to the moniker of the object
ppunkObject  Address of output variable that receives the IUnknown interface pointer
Returns:
An HRESULT indicating success or failure

HRESULT Rot_GetTimeOfLastChange (  LPMONIKER    pmkObjectName,
FILETIME *    lpfiletime
)  [inline]
 

Retrieves the last modification time of an object in the Running Object Table.

Returns the time that an object was last modified. The object must have previously been registered with the Running Object Table (ROT). This method looks for the last change time recorded in the ROT.

Parameters:
pmkObjectName  Pointer to moniker on the object whose status is desired
lpfiletime  Pointer to structure containing object's last change time
Returns:
An HRESULT indicating success or failure

HRESULT Rot_IsRunning (  LPMONIKER    pmkObjectName )  [inline]
 

Determines if object current in the Running Object Table.

Determines whether the object identified by the specified moniker is currently running. This method looks for the moniker in the Running Object Table (ROT).

Parameters:
pmkObjectName  Pointer to the moniker of the object whose status is desired
Returns:
An HRESULT indicating success or failure

HRESULT Rot_NoteChangeTime (  DWORD    dwRegister,
FILETIME *    lpfiletime
)  [inline]
 

Retrieves the last modification time of a running object in the Running Object Table.

Records the time that a running object was last modified. The object must have previously been registered with the Running Object Table (ROT). This method stores the time of last change in the ROT.

Parameters:
dwRegister  Value identifying registration being updated
lpfiletime  Pointer to structure containing object's last change time
Returns:
An HRESULT indicating success or failure

HRESULT Rot_Register (  DWORD    grfFlags,
LPUNKNOWN    punkObject,
LPMONIKER    pmkObjectName,
DWORD *    pdwRegister
)  [inline]
 

Registers an object in the Running Object Table.

Registers an object and its identifying moniker in the Running Object Table (ROT).

Parameters:
grfFlags  Registration options
punkObject  Pointer to the object being registered
pmkObjectName  Pointer to the moniker of the object being registered
pdwRegister  Pointer to the value identifying the registration
Returns:
An HRESULT indicating success or failure

HRESULT Rot_Revoke (  DWORD    dwRegister )  [inline]
 

Removes an object from the Running Object Table.

Removes from the Running Object Table (ROT) an entry that was previously registered by a call to Rot_Register().

Parameters:
dwRegister  Value identifying registration to be revoked
Returns:
An HRESULT indicating success or failure
STLSoft Libraries documentation © Synesis Software Pty Ltd, 2001-2004