Compartilhar via


Revogação e renovação de componente automatizado

[O recurso associado a esta página, do SDK do Windows Media Format 11, é um recurso herdado. Foi substituído por de Leitor de Origem e do Gravador do Coletor de. de Leitor de Origem e Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use de Leitor de Origem e o Gravador do Coletor em vez de 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.]

Aplicativos ou componentes de software considerados comprometidos podem ser revogados pela Microsoft. A API Estendida do Cliente de Formato de Mídia do Windows fornece um mecanismo para a revogação automatizada e a renovação de componentes.

Os componentes revogados são listados em uma lista de revogação de certificado, que é publicada pela Microsoft. Quando um componente é revogado, seu certificado é adicionado à lista de revogação de certificados e o BLOB de informações de revogação (REV_INFO) é atualizado nos servidores da Microsoft.

Para executar a revogação e a renovação automatizadas quando um usuário tenta processar o conteúdo protegido do DRM do Windows Media, seu aplicativo deve fazer o seguinte:

  1. Extraia a versão REV_INFO da licença. O número de versão REV_INFO está localizado no seguinte local em uma licença XMR:

    <LICENSE version="2.0.0.0">
        <LICENSORINFO/>
        <DATA>
            <LID>...</LID>
            <KID>...</KID>
            <RevInfoVersion>42</RevInfoVersion>
            ...
         </DATA>
    ....
    </LICENSE>
    
  2. Compare o número de versão REV_INFO da licença com o número de versão REV_INFO no repositório local chamando o métodoIWMDRMSecurity::GetRevocationDataVersion.

  3. Se a versão REV_INFO não estiver atualizada, chame o método IWMDRMSecurity::P erformSecurityUpdate, passando o sinalizador WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH no parâmetro dwFlags.

  4. Recupere a lista de revogação de certificados do repositório local chamando o método IWMDRMSecurity::GetRevocationData.

  5. Analise a lista de revogação e verifique se há revogações de DRM do Windows Media. Para obter mais informações, consulte verificandode revogação de certificado.

  6. Se houver revogações de DRM do Windows Media:

    1. Crie um habilitador de conteúdo para renovar os componentes revogados chamando o método IWMDRMSecurity::GetContentEnablersForRevocations método.

    2. Chame IMFContentEnabler::AutomaticEnable que direciona o usuário para uma URL que contém informações de renovação de componente. Esse método está documentado no do SDK do Media Foundation (https://msdn.microsoft.com/library/ms694197(VS.85).aspx).

      Nota

      Você deve esclarecer esse processo ao usuário por meio do uso de uma declaração de privacidade, pois o processo de atualização envia informações do computador cliente para um site da Microsoft.

       

    3. Se possível, o usuário renovará o componente da URL, automaticamente ou seguindo instruções específicas. Haverá algumas situações em que o componente não pode ser renovado.

    4. Tente acessar o conteúdo novamente até que não haja mais revogações ou o processo seja interrompido por algum motivo.

guia de programação