Windows Dev Center

IRunningObjectTable::EnumRunning method

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).

Syntax


HRESULT EnumRunning(
  [out] IEnumMoniker **ppenumMoniker
);

Parameters

ppenumMoniker [out]

A pointer to an IEnumMoniker pointer variable that receives the interface pointer to the new enumerator for the ROT. When successful, the implementation calls AddRef on the enumerator; it is the caller's responsibility to call Release. If an error occurs; the implementation sets *ppenumMoniker to NULL.

Return value

This method can return the standard return values E_OUTOFMEMORY and S_OK.

Remarks

IRunningObjectTable::EnumRunning must create and return a pointer to an IEnumMoniker interface on an enumerator object. The standard enumerator methods can then be called to enumerate the monikers currently registered in the registry. The enumerator cannot be used to enumerate monikers that are registered in the ROT after the enumerator has been created.

The EnumRunning method is intended primarily for the use by the system in implementing the alert object table. Note that OLE 2 does not include an implementation of the alert object table.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IRunningObjectTable is defined as 00000010-0000-0000-C000-000000000046

See also

IEnumMoniker
IRunningObjectTable

 

 

Community Additions

ADD
Show:
© 2015 Microsoft