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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

解説

このメソッドは非同期的に実行されます。 呼び出された直後に を返し、 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 イベントが生成されます。

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

要件

関連項目

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

DRM の個別化の例

IWMDRMSecurity インターフェイス

DRM の個別化の実行