Edit

IEnumNames::Next method (comsvcs.h)

  • Article

Retrieves the specified number of items in the enumeration sequence.

Syntax

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

Parameters

[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.

Return value

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.

Requirements

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

See also

IEnumNames