Previous | Next |
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
Previous | Next |