IWMDMStorage4：：GetRightsWithProgress 方法 (mswmdm.h)

GetRightsWithProgress 方法會擷取記憶體物件的許可權資訊，並提供監視進度的回呼機制。

語法

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

[in] pIProgressCallback

Windows 媒體裝置管理員用來回報進度給應用程式的 IWMDMProgress3 介面選擇性指標。

[out] ppRights

WMDMRIGHTS 結構的數位指標，其中包含記憶體物件許可權資訊。此陣列的記憶體是由 Windows Media 裝置管理員所配置。當呼叫應用程式完成存取此陣列時，必須使用 CoTaskMemFree 釋放記憶體。

[out] pnRightsCount

ppRights 陣列中 WMDMRIGHTS 結構的指標。

方法會傳回 HRESULT。 Windows Media 裝置管理員中的所有介面方法都可以傳回下列任何一種錯誤碼類別：

如需可能錯誤碼的廣泛清單，請參閱錯誤碼。

物件許可權描述數位媒體內容的使用許可權。例如， WMDMRIGHTS 結構可以包含可播放檔案次數和可播放檔案次數的相關信息。

從授權檔案擷取許可權有時可能是冗長的要求;此函式允許以異步方式執行許可權要求。

除了進度通知之外，安全內容提供者還可以在回呼 pIProgressCallback 上產生事件通知。這類事件的範例包括取得安全時鐘、初始化DRM等等。這些事件會在 IWMDMProgress3：:P rogress3 中說明。

這個方法與 IWMDMStorage：：GetRights 相同，但會傳回進度，而且不會提供 MAC 進行參數驗證。