IWMDRMLicenseQuery：：QueryActionAllowed 方法
[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows Media Format 11 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
QueryActionAllowed方法會在本機授權存放區上執行查詢，以擷取套用至指定金鑰識別碼之一或多個 DRM 動作的授權狀態。
語法
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
參數
-
bstrKID [in]
-
要查詢的金鑰識別碼。 只會評估套用至此金鑰識別碼的授權。
-
bstrMinReqIndivVersion [in]
-
ASF 檔案標頭中指定的最低安全性版本。 這是選擇性參數。 傳遞 Null 來執行查詢，而不需此資訊。
-
cActionsToQuery [in]
-
要查詢的動作數目。 此值必須設定為針對 rgbstrActionsToQuery 和 rgdwQueryResult 參數傳遞之陣列中的元素數目。
-
rgbstrActionsToQuery[] [in]
-
要查詢之一或多個許可權的陣列。 此陣列必須包含 cActionsToQuery所指定的元素數目。 每個元素都必須設定為下列其中一個常數：
常數 描述 g_wszWMDRM_ActionAllowed_Playback 包含 以查詢播放內容的權利。 g_wszWMDRM_ActionAllowed_Copy 包含 以查詢將內容複寫到外部裝置或媒體的權利。 g_wszWMDRM_ActionAllowed_PlaylistBurn 包含 以查詢將內容複寫到 CD 作為播放清單一部分的權利。 g_wszWMDRM_ActionAllowed_CreateThumbnailImage 包含 以查詢許可權以從內容建立縮圖影像。 g_wszWMDRM_ActionAllowed_CopyToCD 包含 以查詢將內容複寫到 CD 的權利。 -
rgdwQueryResult[] [out]
-
一或多個 DWORD 變數的陣列，這些變數會接收 rgbstrActionsToQuery所指定許可權的查詢結果。 如果允許動作，對應的元素會設定為零。 如果不允許動作，元素會設定為使用位 OR 運算結合 之DRM_ACTION_ALLOWED_QUERY_RESULTS 列舉的一或多個值。 此陣列必須包含 cActionsToQuery所指定的元素數目。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
備註
查詢播放和複製許可權時，您會先設定環境參數，以取得更精確的結果。 使用 SetActionAllowedQueryParams 方法來設定環境參數。 環境參數不會影響對待用許可權的查詢結果;您可以安全地使用預設值。
QueryActionAllowed方法傳回的結果會從本機授權存放區中的零或多個授權匯總。 如果方法遇到已啟用的結果，則可能不會搜尋套用至金鑰識別碼的所有授權。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|