共用方式為


IWMDRMLicenseQuery::QueryLicenseState 方法

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器,而不是Windows 媒體格式 11 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

QueryLicenseState方法會查詢本機授權存放區,以取得適用于一或多個特定許可權之金鑰識別碼的授權資訊。

語法

HRESULT QueryLicenseState(
  [in]  BSTR                   bstrKID,
  [in]  DWORD                  cActionsToQuery,
  [in]  BSTR                   rgbstrActionsToQuery[],
  [out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);

參數

bstrKID [in]

要查詢的金鑰識別碼。 只會評估套用至此金鑰識別碼的授權。

cActionsToQuery [in]

要查詢的動作數目。 此值必須設定為針對 rgbstrActionsToQueryrgResultStateData 參數傳遞之陣列中的元素數目。

rgbstrActionsToQuery[] [in]

要查詢的一或多個許可權陣列。 此陣列必須包含 cActionsToQuery所指定的專案數目。 每個元素都必須設定為下列其中一個常數。

常數 描述
g_wszWMDRM_LicenseState_Backup 包含 以查詢有關備份和還原授權之許可權的詳細資料。
g_wszWMDRM_LicenseState_CollaborativePlay 包含 以查詢許可權的相關詳細資料,以在共同作業播放案例中與一組使用者共用內容。
g_wszWMDRM_LicenseState_Copy 包含 以查詢有關將內容複寫到外部裝置或媒體之許可權的詳細資料。
g_wszWMDRM_LicenseState_CopyToCD 包含 以查詢有關將內容複寫到 CD 之許可權的詳細資料。
g_wszWMDRM_LicenseState_CopyToNonSDMIDevice 包含 以查詢有關將內容複寫到不支援安全數位媒體方案之裝置的詳細資料, (SDMI) 。
g_wszWMDRM_LicenseState_CopyToSDMIDevice 包含 以查詢有關將內容複寫到支援 SDMI 之裝置之許可權的詳細資料。
g_wszWMDRM_LicenseState_CreateThumbnailImage 包含 以查詢有關從內容建立縮圖影像之許可權的詳細資料。
g_wszWMDRM_LicenseState_Playback 包含 以查詢有關播放內容之許可權的詳細資料。
g_wszWMDRM_LicenseState_PlaylistBurn 包含 以查詢有關將內容複寫到 CD 作為播放清單一部分之許可權的詳細資料。

rgResultStateData[] [out]

一或多個 DRM_LICENSE_STATE_DATA 結構的陣列,這些結構會接收套用至 rgbstrActionsToQuery 參數對應元素中右邊的授權狀態資訊。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。

備註

所有套用至指定金鑰識別碼的授權都會經過搜尋和評估。 結果會匯總,因此每個 DRM_LICENSE_STATE_DATA 結構都可能包含來自多個授權的資訊。

規格需求

需求
標頭
Wmdrmsdk.h
程式庫
Wmdrmsdk.lib

另請參閱

IWMDRMLicenseQuery 介面