IMDSPStorageGlobals：：GetCapabilities 方法 (mswmdm.h)
GetCapabilities方法會擷取與此介面實例相關聯之儲存媒體的功能。
語法
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
參數
[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 |
| 程式庫 | Mssachlp.lib |