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

このメソッドのパラメーターデータのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されます。

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

オブジェクト権限は、メディアコンテンツの使用アクセス許可を表します。たとえば、 WMDMRIGHTS 構造体には、ファイルを再生できる回数と再生できるユーザーに関する情報を含めることができます。

ppRights 配列はこのメソッドによって割り当てられ、標準の Win32 関数である CoTaskMemFree を使用してアプリケーションによって解放される必要があります。

このメソッドは省略可能です。詳細については、「必須インターフェイスと省略可能なインターフェイス」を参照してください。