IMDSPStorageGlobals：：GetCapabilities 方法 (mswmdm.h)
GetCapabilities 方法检索与此接口的实例关联的存储介质的功能。
语法
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
parameters
[out] pdwCapabilities
指向包含存储介质功能的 DWORD 的指针。
可以在 pdwCapabilities 参数中返回以下标志。
| 标志 | 描述 |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | 介质支持存储根目录中的文件夹。 |
| WMDM_STORAGECAP_FILESINROOT | 介质支持存储根目录中的文件。 |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | 媒体支持文件夹中的文件夹。 |
| WMDM_STORAGECAP_FILESINFOLDERS | 媒体支持文件夹中的文件。 |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | 媒体对每个文件夹支持形式允许的文件夹数有任意计数限制。 |
| WMDM_STORAGECAP_FILELIMITEXISTS | 媒体对每个文件支持形式允许的文件数有任意计数限制。 |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | 无法初始化介质。 默认情况下，可以初始化顶级存储。 |
对于受保护的设备实现，还可以返回描述媒体权限功能的以下标志。
| 标志 | 描述 |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | 媒体支持内容的播放计数限制。 |
| WMDM_RIGHTS_EXPIRATIONDATE | 媒体支持内容的过期日期跟踪。 |
| WMDM_RIGHTS_FREESERIALIDS | 媒体支持文件的可用串行标识符。 |
| WMDM_RIGHTS_GROUPID | 媒体支持文件的组标识符。 |
| WMDM_RIGHTS_NAMEDSERIALIDS | 媒体支持文件的命名串行标识符。 |
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码：
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
尝试使用 IMDSPObject 接口对存储介质执行不受支持的操作会返回错误代码。 可以调用 GetCapabilities 方法以确定操作是否预期在正常情况下会成功。
如果WMDM_STORAGECAP_FILELIMITEXISTS标志或WMDM_STORAGECAP_FOLDERLIMITEXISTS标志为 true，则可创建的文件或文件夹数存在任意限制。 通过 IMDSPObject 接口进行的超出这些限制的操作将失败。
必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息，请参阅 必需接口和可选接口。
要求
| 目标平台 | Windows |
| 标头 | mswmdm.h |
| Library | Mssachlp.lib |