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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
解説
取り消されたコンポーネントを更新するために IMFContentEnabler インターフェイスを使用する場合は、ユーザーにプロセスを明確にする必要があります。 更新プロセスによってクライアント コンピューターから Microsoft Web サイトに情報が送信されるため、この説明を行う必要があります。
IMFContentEnabler::AutomaticEnable を呼び出すと、コンテンツ イネーブラーは、Microsoft Web サイト上の更新サービスのアドレスを使用して既定のブラウザーを起動します。 取り消されたコンポーネントを識別する一意識別子が更新サービスに送信されます。 その後、このサービスはブラウザーを Web ページにリダイレクトします。このページから、取り消されたコンポーネントの新しいバージョンをユーザーがダウンロードしてインストールできます。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|