IEnumNames::Next method (comsvcs.h)

Retrieves the specified number of items in the enumeration sequence.

Syntax

HRESULT Next(
  [in]  unsigned long celt,
  [out] BSTR          *rgname,
  [out] unsigned long *pceltFetched
);

[in] celt

The number of name values being requested.

[out] rgname

An array in which the name values are to be returned and which must be of at least the size defined in the celt parameter.

[out] pceltFetched

The number of elements returned in rgname, or NULL.

This method can return the standard return values E_INVALIDARG, E_POINTER, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code	Description
S_OK	All elements requested were obtained successfully.
S_FALSE	The number of elements returned is less than the number specified in the celt parameter.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comsvcs.h