IEnumDMO::Next

This method retrieves a specified number of items in the enumeration sequence.

HRESULT Next(
  DWORD cItemsToFetch,
  CLSID* pCLSID,
  WCHAR** Names,
  DWORD* pcItemsFetched
);

Parameters

  • cItemsToFetch
    Number of items to retrieve.
  • pCLSID
    [out] Array of size cItemsToFetch that is filled with the CLSIDs of the enumerated DMOs.
  • Names
    [out] Array of size cItemsToFetch that is filled with the friendly names of the enumerated DMOs.
  • pcItemsFetched
    [out] Pointer to a variable that receives the actual number of items retrieved. This parameter can be NULL if cItemsToFetch equals 1.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
S_FALSE Retrieved fewer items than requested
S_OK Retrieved the requested number of items
E_INVALIDARG Invalid argument
E_OUTOFMEMORY Insufficient memory
E_POINTER NULL pointer argument

Remarks

If the method succeeds, the arrays given by the pCLSID and Names parameters are filled with CLSIDs and wide-character strings. The value of *pcItemsFetched specifies the number of items returned in these arrays.

The method returns S_OK if it retrieves the requested number of items; in other words, if *pcItemsFetched equals cItemsToFetch. Otherwise, it returns S_FALSE or an error code.

The caller must free the memory allocated for each string returned in the Names parameter using the CoTaskMemFree function.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Dmo.h.
Link Library: Dmoguid.lib.

See Also

IEnumDMO

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.