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

Статья
08/25/2023

Метод FindStorage находит хранилище по постоянному уникальному идентификатору. В отличие от других методов, этот метод может выполнять рекурсивный поиск из корневого хранилища.

Синтаксис

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

Параметры

[in] findScope

Перечисление WMDM_FIND_SCOPE, указывающее область операции поиска.

[in] pwszUniqueID

Строка с расширенным символом со значением NULL, представляющая постоянный уникальный идентификатор хранилища, который можно получить, запросив свойство g_wszWMDMPersistentUniqueID хранилища.

[out] ppStorage

Указатель на возвращенное хранилище. По завершении работы вызывающий объект должен освободить этот интерфейс.

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

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

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