Share via

3.1.4.6.1 get__NewEnum (Opnum 7)

  • Article

The get__NewEnum method gets a DCOM object for enumerating the underlying collection.

 [id(DISPID_NEWENUM), propget, restricted, helpstring("Create new IEnumVARIANT")] HRESULT _NewEnum(
   [out, retval] IUnknown** ppUnkEnum
 );

ppUnkEnum: If the function returns a success HRESULT, this MUST contain a DCOM object which implements the IEnumEventObject interface.

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 ppUnkEnum interface.