Método IWMDRMSecurity::GetContentEnablersFromHashes

[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 de 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 de 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 GetContentEnablersFromHashes recupera interfaces do habilitador de conteúdo que permitem a renovação de componentes com base em certificados hash.

Sintaxe

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

Parâmetros

rgpbCertHashes [in]

Matriz de hashes de certificado para o qual obter habilitadores de conteúdo.

cCerts [in]

Número de certificados para os qual recuperar habilitadores de conteúdo. Esse é o número de elementos na matriz rgpbCertHashes .

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.

Comentários

Se você usar a interface IMFContentEnabler para renovar 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 para o serviço de atualização. Em seguida, o serviço redireciona o navegador para uma página da Web da qual o usuário poderá baixar e instalar a nova versão do componente revogado.

Requisitos

Confira também

IWMDRMSecurity Interface