Método IWMDRMSecurity::GetContentEnablersForRevocations
[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador do Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O método GetContentEnablersForRevocations recupera interfaces de habilitador de conteúdo que permitem a renovação de componentes com base em certificados revogados.
Sintaxe
HRESULT GetContentEnablersForRevocations(
[in] BYTE **rgpbCerts,
[in] DWORD *rgpdwCertSizes,
[in] GUID **rgpguidCerts,
[in] DWORD cCerts,
[in] HRESULT hResultHint,
[out] IMFContentEnabler **prgContentEnablers,
[in, out] DWORD *pcContentEnablers
);
Parâmetros
-
rgpbCerts [in]
-
Matriz de certificados para os qual recuperar habilitadores de conteúdo. O número de elementos na matriz deve ser especificado por cCerts.
-
rgpdwCertSizes [in]
-
Matriz que contém os tamanhos dos certificados na matriz rgpbCerts . O número de elementos na matriz deve ser especificado por cCerts.
-
rgpguidCerts [in]
-
Matriz que contém os tipos de certificados na matriz rgpbCerts . O número de elementos na matriz deve ser especificado por cCerts. Para cada elemento da matriz, use um dos valores a seguir.
Constante GUID Descrição WMDRM_REVOCATIONTYPE_APP Especifica um certificado de aplicativo. WMDRM_REVOCATIONTYPE_DEVICE Especifica um certificado de dispositivo. WMDRM_REVOCATIONTYPE_CARDEA Especifica um certificado DRM do Windows Media para Dispositivos de Rede. -
cCerts [in]
-
Número de certificados para os qual recuperar habilitadores de conteúdo. Esse é o número de elementos na matriz rgpbCerts , na matriz rgpdwCertSizes e na matriz rgpguidCerts .
-
hResultHint [in]
-
Valor retornado recebido da operação que falhou devido a um certificado revogado. Se você não estiver chamando em resposta a uma chamada de método com falha, defina como S_OK.
-
prgContentEnablers [out]
-
Matriz que recebe os endereços das interfaces IMFContentEnabler recém-criadas. Defina como NULL para obter o número de habilitadores de conteúdo no parâmetro pcContentEnablers .
-
pcContentEnablers [in, out]
-
Número de elementos na matriz prgContentEnablers . Se prgContentEnablers for NULL, esse valor será definido como o número de habilitadores de conteúdo necessários na saída.
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Comentários
Se você usar a interface IMFContentEnabler para renovar os componentes revogados, deverá esclarecer o processo ao usuário. Esse esclarecimento deve ser feito porque o processo de atualização envia informações do computador cliente para um site da Microsoft.
Quando você chama IMFContentEnabler::AutomaticEnable, o habilitador de conteúdo inicia o navegador padrão com o endereço do serviço de atualização no site da Microsoft. Um identificador exclusivo que identifica o componente revogado é enviado ao serviço de atualização. Em seguida, o serviço redireciona o navegador para uma página da Web da qual o usuário pode baixar e instalar a nova versão do componente revogado.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|