Windows Media Format SDK banner art
PreviousNext

IWMDMEnumStorage::Next

The Next method retrieves a pointer to the next IWMDMStorage or IWMDMDevice interface.

Syntax

HRESULT Next(
  ULONG  celt,
  IWMDMStorage**  ppStorage,
  ULONG*  pceltFetched
);

Parameters

  celt

[in]  Number of storages requested.

  ppStorage

[out]  Pointer to a storage device.

  pceltFetched

[out]  Number of storage devices enumerated.

Return Values

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

Return code Description
S_FALSE No more storage devices exist.
E_INVALIDARG A parameter is invalid or is a NULL pointer.
E_FAIL An unspecified error occurred.

Remarks

The Windows NT 4.0 operating system cannot detect when a user physically disconnects a device. Therefore, when a device is disconnected, the Next method does not return zero in pceltFetched or NULL in ppStorage.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.