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