Windows Media Format SDK banner art
PreviousNext

IWMDMEnumStorage::Skip

The Skip method skips over the specified number of storage devices or separate items of content in the enumeration sequence.

Syntax

HRESULT Skip(
  ULONG  celt,
  ULONG*  pceltFetched
);

Parameters

  celt

[in]  Number of devices or content items that must not be enumerated.

  pceltFetched

[out]  Number of storage devices or content items 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 number of elements specified was not skipped.
E_INVALIDARG A parameter is invalid or is a NULL pointer.
E_FAIL An unspecified error occurred.

Remarks

If the number of devices specified in celt 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, pceltFetched must be queried to determine how many interfaces were actually skipped. If you skip to the end of the array of storage interfaces, a subsequent call to Next returns S_FALSE.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.