IWMDRMDevice::GetMeterChallenge メソッド

GetMeterChallenge メソッドは、測定チャレンジを取得します。

構文

HRESULT GetMeterChallenge(
  [in]  BSTR  bstrMeterCert,
  [out] BYTE  **ppbMeterChallenge,
  [out] DWORD *pcbMeterChallenge
);

パラメーター

bstrMeterCert [in]

コンテンツ所有者がデバイス上の関連する使用状況測定データを収集するためにホスト コンピューターに送信する使用状況測定証明書

ppbMeterChallenge [out]

測定チャレンジの結果を取得しました。

pcbMeterChallenge [out]

測定チャレンジのサイズ (バイト単位)。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。

解説

測定データは収集され、測定が有効になっているコンテンツのデバイス上の DRM データ ストアに格納されます。 再生などのアクションが記録されます。 この関数が呼び出されると、デバイスは DRM データ ストア内の測定データを XML ドキュメントの形式で収集し、ホスト コンピューターに送信します。 データが多すぎる場合は、フェーズで送信されます。

ホスト コンピューターは、使用状況測定データを受信すると、インターネット経由で使用状況測定証明書で指定された URL にデータを送信します。

要件

要件	値
ヘッダー	WMDDRMSP.idl
ライブラリ	Mssachlp.lib

関連項目

IWMDRMDevice インターフェイス