Поделиться через

Метод IMDSPDevice2::GetStorage (mswmdm.h)

  • Статья

Метод GetStorage позволяет перейти непосредственно к хранилищу на основе его имени, а не перечислять все хранилища для его поиска.

Синтаксис

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

Параметры

[in] pszStorageName

Указатель на строку, завершающуюся значением NULL, которая содержит имя искать хранилище.

[out] ppStorage

Указатель на объект хранилища, указанный параметром pszStorageName .

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

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

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

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

Если этот метод не реализован, он должен вернуть E_NOTIMPL. (Он не должен возвращать WMDM_E_NOT_SUPPORTED или другие коды, указывающие на то, что этот метод не реализован. Это гарантирует, что диспетчер устройств Windows Media попытается заменить эту функцию, перечислив все хранилища, чтобы найти совпадение на основе имени хранилища, переданного как pszStorageName.

Настоятельно рекомендуется, чтобы поставщик услуг реализовал этот метод, чтобы эффективно возвращать объект хранилища на основе имени.

Этот метод является необязательным. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

См. также раздел

Интерфейс IMDSPDevice2