Метод IMDSPDevice3::FindStorage (mswmdm.h)

Статья
08/25/2023

Метод 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 диспетчер устройств вызывает этот метод в поставщике услуг (SP).

Постоянный уникальный идентификатор используется для уникальной идентификации содержимого, хранящегося на определенном устройстве. Он не представляет глобально уникальный идентификатор для конкретного содержимого, который остается идентичным на всех устройствах. Таким образом, одно и то же содержимое, хранящееся в разных хранилищах, будет иметь разные постоянные уникальные идентификаторы.

Windows Media диспетчер устройств вызывает этот метод только для зарегистрированных устройств, чтобы включить синхронизацию с Медиаплеер Windows. Дополнительные сведения см. в разделе Включение синхронизации с Медиаплеер Windows.