Método IWMDRMSecurity::GetContentEnablersForRevocations

  • Artigo

[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
S_OK
 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
Wmdrmsdk.h
Biblioteca
Wmdrmsdk.lib

Confira também

Revogação e renovação de componentes automatizados

IWMDRMSecurity Interface