IWMDRMSecurity::P erformSecurityUpdate メソッド

  • [アーティクル]

[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

PerformSecurityUpdate メソッドは、ローカル コンピューター上の DRM サブシステムに対するセキュリティ更新プログラムを開始します。

構文

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

パラメーター

dwFlags [in]

Update オプションは、次のいずれかのフラグとして表されます。

フラグ 説明
WMDRM_SECURITY_PERFORM_INDIV クライアントのバージョンが古い場合にのみ、DRM コンポーネントを個別化します。
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH クライアント コンピューターの失効リストを更新します。
WMDRM_SECURITY_PERFORM_FORCE_INDIV クライアントのバージョンが最新の場合でも、DRM コンポーネントを個別化します。

ppunkCancelationCookie [out]

この操作を取り消すために使用できるオブジェクトへのポインターを受け取る変数のアドレス。

戻り値

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

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

解説

このメソッドは非同期的に実行されます。 呼び出された直後に を返し、 dwFlags パラメーターに設定されているフラグに応じてイベントを生成します。

個別化 (WMDRM_SECURITY_PERFORM_INDIVまたはWMDRM_SECURITY_PERFORM_FORCE_INDIVに設定されたフラグ) の場合、一連の MEWMDRMIndividualizationProgress イベントが生成され、処理が完了すると MEWMDRMIndividualizationCompleted イベントが生成されます 。 IMFMediaEvent::GetValue を呼び出して取得した各 MEWMDRMIndividualizationProgress イベントの値は、IUnknown ポインターです。 取得した IUnknown インターフェイスの QueryInterface メソッドを呼び出して、IWMDRMIndividualizationStatus インターフェイスのインスタンスを取得できます。

失効リストを更新するために (フラグをWMDRM_SECURITY_PERFORM_REVOCATION_REFRESHに設定)、処理が完了すると MEWMDRMREvocationDownloadCompleted イベントが生成されます。

注意

PerformSecurityUpdate が個別化を完了すると、新しい個別化された状態を反映する既存のオブジェクトは、IWMDRMSecurity から継承されるオブジェクトだけです。 他のすべての既存のオブジェクトは更新されません。 新しい個別化された状態を反映するように、他のオブジェクトを解放して再作成する必要があります。

Windows Media DRM クライアント拡張 API の非同期メソッドの使用の詳細については、「 Media Foundation イベント モデルの使用」を参照してください。

要件

要件 値
ヘッダー
Wmdrmsdk.h
ライブラリ
Wmdrmsdk.lib

関連項目

コンポーネントの自動失効と更新

DRM の個別化の例

IWMDRMSecurity インターフェイス

DRM の個別化の実行