IWMDRMDeviceApp::SynchronizeLicenses メソッド

SynchronizeLicenses メソッドは、有効期限が近づくとデバイスのライセンスを更新します。

構文

HRESULT SynchronizeLicenses(
  [in] IWMDMDevice    *pDevice,
  [in] IWMDMProgress3 *pProgressCallback,
  [in] DWORD          cMinCountThreshold,
  [in] DWORD          cMinHoursThreshold
);

パラメーター

pDevice [in]

IWMDMDevice オブジェクトへのポインター。

pProgressCallback [in]

実行する必要がある可能性があるステップの進行状況を受け取る進行状況コールバック。このステップは、呼び出された IWMDMProgress3 メソッドの EventId パラメーターによって識別されます。

cMinCountThreshold [in]

デバイス ライセンスの残りの最小再生数 (省略可能)。

cMinHoursThreshold [in]

デバイス ライセンスの残り時間 (省略可能)。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
DRM_E_INVALIDARG	1 つ以上の引数が無効です。
DRM_E_INVALIDXMLTAG	XML の形式が正しくありません。
DRM_E_NOTIMPL	この機能は現在実装されていません。 (SyncLicenses w/ pDevice =NULL)
DRM_E_NOXMLCLOSETAG	ライセンス XML の形式が正しくありません。
DRM_E_NOXMLOPENTAG	ライセンス XML の形式が正しくありません。
DRM_E_OUTOFMEMORY	メモリが不足しています。
DRM_E_XMLNOTFOUND	ライセンスで必要な XML タグを見つけることができませんでした。
NS_E_DEVICE_NOT_WMDRM_DEVICE	指定されたデバイスは、Windows Media DRM 互換デバイスではありません。
NS_E_DRM_NEEDS_INDIVIDUALIZATION	DRM では、この機能を実行するために個別のブラック ボックスが必要です。 つまり、Windows Media Format SDK にはセキュリティ アップグレードが必要です。

解説

この呼び出しは、ポータブル デバイス用の Windows Media DRM 10 をサポートするデバイスでのみ行うことができます。 少なくとも 1 つのしきい値パラメーターを指定する必要があります。

必要条件

要件	値
ヘッダー	WMDRMDeviceApp.h (WMDRMDeviceApp.idl からビルドされたWmdrmdeviceapp_i.c も必要です)
ライブラリ	Mssachlp.lib

関連項目

アプリケーションでの保護されたコンテンツの処理

IWMDMProgress3 インターフェイス

IWMDRMDeviceApp インターフェイス