Метод IMDSPStorage4::FindStorage (mswmdm.h)
Метод FindStorage находит хранилище с заданным постоянным уникальным идентификатором. Постоянный уникальный идентификатор хранилища описывается свойством g_wszWMDMPersistentUniqueID этого хранилища.
Синтаксис
HRESULT FindStorage(
[in] WMDM_FIND_SCOPE findScope,
[in] LPCWSTR pwszUniqueID,
[out] IMDSPStorage **ppStorage
);
Параметры
[in] findScope
Область операции поиска. Это должно быть одно из следующих значений.
| Значение | Описание |
|---|---|
| WMDM_FIND_SCOPE_GLOBAL | Выполните поиск по всему устройству. |
| WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN | Поиск только в непосредственных дочерних элементах текущего хранилища. |
[in] pwszUniqueID
Постоянный уникальный идентификатор хранилища.
[out] ppStorage
Указатель на возвращаемое хранилище, указанное параметром pwszUniqueID .
Возвращаемое значение
Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:
- Стандартные коды ошибок COM
- Коды ошибок Windows, преобразованные в значения HRESULT
- Коды ошибок диспетчер устройств Windows Media
Комментарии
Поставщик услуг возвращает постоянный уникальный идентификатор через свойство g_wszWMDMPersistentUniqueID хранилища. Для определенного хранилища постоянный уникальный идентификатор, предоставленный поставщиком услуг, должен быть одинаковым в разных сеансах подключения устройства.
Приложение может вызвать FindStorage с этим постоянным уникальным идентификатором позже. В ответ Windows Media диспетчер устройств вызывает этот метод у поставщика услуг.
Постоянный уникальный идентификатор используется для уникальной идентификации содержимого, хранящегося на определенном устройстве. Он не представляет глобально уникальный идентификатор для конкретного содержимого, который остается идентичным на всех устройствах. Таким образом, одно и то же содержимое, хранящееся в разных хранилищах, будет иметь разные постоянные уникальные идентификаторы.
Этот метод позволяет искать хранилище на основе постоянного уникального идентификатора, а IMDSPStorage2::GetStorage позволяет искать хранилище на основе имени.
Windows Media диспетчер устройств вызывает этот метод только для устройств, которые можно синхронизировать с Медиаплеер Windows. Дополнительные сведения см. в разделе Включение синхронизации с Медиаплеер Windows.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |