Метод IWMDMStorage4::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

Постоянный уникальный идентификатор найденного хранилища. Постоянный уникальный идентификатор хранилища описывается свойством метаданных g_wszWMDMPersistentUniqueID хранилища.

[out] ppStorage

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

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

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

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

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

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

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