Share via

IWMDMStorage4::FindStorage

  • Article
banner art

The FindStorage method retrieves a storage in the current root storage, based on its persistent unique identifier.

Syntax

HRESULT FindStorage(WMDM_FIND_SCOPEfindScope,LPCWSTRpwszUniqueID,IWMDMStorage**ppStorage);

Parameters

findScope

[in]  A WMDM_FIND_SCOPE enumeration specifying the scope to search.

pwszUniqueID

[in]  Persistent unique identifier of the storage to be found. The persistent unique identifier of the storage is described by the g_wszWMDMPersistentUniqueID metadata property of the storage.

ppStorage

[out]  Pointer to the retrieved storage, if found. The caller must release this interface when done with it.

Return Values

The method returns an HRESULT. All the interface methods in Windows Media Device Manager can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes

For an extenstive list of possible error codes, see Error Codes.

Possible values include, but are not limited to, those in the following table. If the method fails with an error, it returns a standard error code.

Return code Description
S_OK The method succeeded and storage matching the persistent unique identifier was found.
E_INVALIDARG The findScope is not valid, or pwszUniqueID or ppStorage is NULL.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) No storage found with the specified persistent unique identifier.

Remarks

This method only searches a single memory object (flash card or hard disc) on the device.

A persistent unique identifier identifies content stored on a particular device. It does not represent a content-specific globally unique identifier that remains identical across all devices. Thus, the same content stored in different storages will have different persistent unique identifiers. Similarly, different content may have the same persistent unique identifier when stored on different devices.

The format of the persistent unique identifier depends on the device. The application must have obtained the persistent unique identifier previously by obtaining a storage and querying it for its WMDM/PersistentUniqueID property. Use the GetSpecifiedMetadata or GetMetadata methods to request this property.

Requirements

Header: Defined in mswmdm.h.

Library: mssachlp.lib

See Also