IWMDRMSecurity::GetContentEnablersForRevocations メソッド

  • [アーティクル]

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

GetContentEnablersForRevocations メソッドは、失効した証明書に基づいてコンポーネントの更新を有効にするコンテンツ イネーブラー インターフェイスを取得します。

構文

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

パラメーター

rgpbCerts [in]

コンテンツ イネーブラーを取得する証明書の配列。 配列内の要素の数は cCerts で指定する必要があります。

rgpdwCertSizes [in]

rgpbCerts 配列内の証明書のサイズを含む配列。 配列内の要素の数は cCerts で指定する必要があります。

rgpguidCerts [in]

rgpbCerts 配列内の証明書の型を含む配列。 配列内の要素の数は cCerts で指定する必要があります。 配列の各要素に対して、次のいずれかの値を使用します。

GUID 定数 説明
WMDRM_REVOCATIONTYPE_APP アプリケーション証明書を指定します。
WMDRM_REVOCATIONTYPE_DEVICE デバイス証明書を指定します。
WMDRM_REVOCATIONTYPE_CARDEA ネットワーク デバイスの Windows Media DRM 証明書を指定します。

cCerts [in]

コンテンツ イネーブラーを取得する証明書の数。 これは、 rgpbCerts 配列、 rgpdwCertSizes 配列、および rgpguidCerts 配列内の要素の数です。

hResultHint [in]

失効した証明書が原因で失敗した操作から受け取った戻り値。 失敗したメソッド呼び出しに応答して を呼び出していない場合は、 を S_OK に設定します。

prgContentEnablers [out]

新しく作成された IMFContentEnabler インターフェイスのアドレスを受け取る配列。 pcContentEnablers パラメーターのコンテンツ 有効化子の数を取得するには、NULL に設定します。

pcContentEnablers [in, out]

prgContentEnablers 配列内の要素の数。 prgContentEnablers が NULL の場合、この値は出力時に必要なコンテンツ イネーブラーの数に設定されます。

戻り値

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

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

解説

取り消されたコンポーネントを更新するために IMFContentEnabler インターフェイスを使用する場合は、ユーザーにプロセスを明確にする必要があります。 更新プロセスによってクライアント コンピューターから Microsoft Web サイトに情報が送信されるため、この説明を行う必要があります。

IMFContentEnabler::AutomaticEnable を呼び出すと、コンテンツ イネーブラーは、Microsoft Web サイト上の更新サービスのアドレスを使用して既定のブラウザーを起動します。 取り消されたコンポーネントを識別する一意識別子が更新サービスに送信されます。 その後、このサービスはブラウザーを Web ページにリダイレクトします。このページから、取り消されたコンポーネントの新しいバージョンをユーザーがダウンロードしてインストールできます。

要件

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

関連項目

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

IWMDRMSecurity インターフェイス