Share via

3.1.4.6.3 get_NewEnum (Opnum 9)

  • Article

The get_NewEnum method gets an IEnumEventObject-based object for enumerating the underlying collection.

 [id(1), propget, helpstring("Create new IEnumEventObject")] HRESULT NewEnum(
   [out, retval] IEnumEventObject** ppEnum
 );

ppEnum: If the function returns a success HRESULT, this MUST contain a DCOM object supporting the IEnumEventObject interface. Note this method is supported only if the underlying collection is of event classes or subscriptions.

Return Values: An HRESULT specifying success or failure. All success codes MUST be treated the same, and all failure codes MUST be treated the same.

When this method is invoked, the server MUST attempt to create a collection-based DCOM object which supports the IEnumEventObject interface, and fail the call, returning a failure HRESULT back to the client if it cannot. The underlying collection MUST be the same collection that is being enumerated by the DCOM object instance servicing this call. The created collection DCOM object MUST be returned through the ppEnum interface.