IWMDRMSecurity::GetContentEnablersFromHashes メソッド

  • [アーティクル]

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

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

構文

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

パラメーター

rgpbCertHashes [in]

コンテンツ の有効化機能を取得するための証明書ハッシュの配列。

cCerts [in]

コンテンツ イネーブラーを取得する証明書の数。 これは rgpbCertHashes 配列内の要素の数です。

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 インターフェイス