Метод IMDSPStorageGlobals::GetCapabilities (mswmdm.h)
Метод GetCapabilities извлекает возможности среды хранения, с которым связан экземпляр этого интерфейса.
Синтаксис
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Параметры
[out] pdwCapabilities
Указатель на DWORD , содержащий возможности среды хранения.
Следующие флаги можно вернуть в параметре pdwCapabilities .
| Flag | Описание |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | Среда поддерживает папки в корне хранилища. |
| WMDM_STORAGECAP_FILESINROOT | Среда поддерживает файлы в корне хранилища. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | Среда поддерживает папки в папках. |
| WMDM_STORAGECAP_FILESINFOLDERS | Среда поддерживает файлы в папках. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Существует произвольное ограничение на количество папок, разрешенных для каждой формы поддержки папок в среде. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Существует произвольное ограничение на количество файлов, разрешенных в разных формах поддержки файлов средой. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | Среда не может быть инициализирована. По умолчанию хранилище верхнего уровня можно инициализировать. |
Для реализаций защищенных устройств также могут быть возвращены следующие флаги, описывающие возможности прав носителя.
| Flag | Описание |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | Среда поддерживает ограничение количества воспроизведения для содержимого. |
| WMDM_RIGHTS_EXPIRATIONDATE | Среда поддерживает отслеживание даты окончания срока действия для содержимого. |
| WMDM_RIGHTS_FREESERIALIDS | Носитель поддерживает бесплатный последовательный идентификатор для файла. |
| WMDM_RIGHTS_GROUPID | Среда поддерживает идентификатор группы для файла. |
| WMDM_RIGHTS_NAMEDSERIALIDS | Носитель поддерживает именованный последовательный идентификатор для файла. |
Возвращаемое значение
Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:
- Стандартные коды ошибок COM
- Коды ошибок Windows, преобразованные в значения HRESULT
- Коды ошибок диспетчер устройств Windows Media
Комментарии
Попытки выполнить неподдерживаемые операции на носителе хранилища с помощью интерфейса IMDSPObject возвращают код ошибки. Метод GetCapabilities можно вызвать, чтобы определить, можно ли ожидать успешного выполнения операции при нормальных обстоятельствах.
Если флаг WMDM_STORAGECAP_FILELIMITEXISTS или флаг WMDM_STORAGECAP_FOLDERLIMITEXISTS имеет значение true, существуют произвольные ограничения на количество файлов или папок, которые можно создать. Операции через интерфейс IMDSPObject , превышающие эти ограничения, завершатся сбоем.
Этот метод должен быть реализован. Он не должен возвращать WMDM_E_NOTSUPPORTED или E_NOTIMPL. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.
Требования
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |