IMDSPEnumStorage::Skip

The Skip method skips over the next specified number of storage interface(s) in the enumeration sequence.

Syntax

HRESULT Skip(
  ULONG  celt,
  ULONG*  pceltFetched
);

Parameters

celt

[in] Number of elements to skip.

pceltFetched

[out] Pointer to the number of elements actually skipped.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Description
S_FALSE	The method did not skip the number of elements requested.
E_FAIL	An unspecified error occurred.

Remarks

If the number to skip specified in the celt parameter is greater than the actual number of storage interfaces remaining in the enumeration sequence, the return value from Skip is S_FALSE. When this happens, the pceltFetched parameter must be queried to determine how many interfaces were skipped. If you skip to the end of the array of storage interfaces, a subsequent call to Next returns S_FALSE.

See Also

IMDSPEnumStorage Interface

Previous

Next