IMDSPStorage：：GetRights 方法 (mswmdm.h)

GetRights 方法會擷取對象的許可權資訊。

語法

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

[out] ppRights

WMDMRIGHTS 結構的數位指標，其中包含記憶體物件許可權資訊。此參數包含在輸出訊息驗證程式代碼中。

[out] pnRightsCount

ppRights 陣列中 WMDMRIGHTS 結構的指標。此參數包含在輸出訊息驗證程式代碼中。

[in, out] abMac

包含這個方法之參數數據的訊息驗證碼的八個字節數位。 (WMDM_MAC_LENGTH 定義為 8.)

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

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

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

ppRights 陣列是由此方法所配置，而且必須使用 CoTaskMemFree，這是標準 Win32 函式的應用程式釋放。

這個方法是一個選擇項目。如需詳細資訊，請參閱強制和選擇性介面。