Share via

3.2.4.2.1.1 _NewEnum (Opnum 7)

  • Article

The _NewEnum method creates a new collection of Objects Being Enumerated.

 [propget, id(DISPID_NEWENUM), restricted] HRESULT _NewEnum(
   [out, retval] IUnknown** unknown
 );

unknown: Pointer to an IUnknown interface pointer. Upon successful completion, receives the IUnknown pointer of a new IEnumVARIANT enumeration for the items in the collection of Objects Being Enumerated. The returned object MUST implement the IEnumVARIANT interface and support enumeration methods on the same data as the IFsrmCollection object. See [MS-OAUT] for IEnumVARIANT protocol documentation.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80004003

E_POINTER

The unknown parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that IUnknown is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST set IUnknown to the IUnknown interface of a new IEnumVARIANT enumeration that contains pointers to all the Objects Being Enumerated in the collection.