Método IWMDRMSecurity::P erformSecurityUpdate

[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 PerformSecurityUpdate inicia uma atualização de segurança para o subsistema DRM no computador local.

Sintaxe

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parâmetros

dwFlags [in]

Opção de atualização expressa como um dos sinalizadores a seguir.

Sinalizador	Descrição
WMDRM_SECURITY_PERFORM_INDIV	Faz com que o componente DRM seja individualizado somente se a versão do cliente estiver desatualizada.
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH	Faz com que as listas de revogação no computador cliente sejam atualizadas.
WMDRM_SECURITY_PERFORM_FORCE_INDIV	Faz com que o componente DRM seja individualizado mesmo que a versão do cliente esteja atualizada.

ppunkCancelationCookie [out]

Endereço de uma variável que recebe um ponteiro para um objeto que pode ser usado para cancelar essa operação.

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

Esse método é executado de forma assíncrona. Ele retorna imediatamente após ser chamado e, em seguida, gera eventos dependendo do sinalizador definido no parâmetro dwFlags .

Para individualização (sinalizador definido como WMDRM_SECURITY_PERFORM_INDIV ou WMDRM_SECURITY_PERFORM_FORCE_INDIV), uma série de eventos MEWMDRMIndividualizationProgress é gerada seguida por um evento MEWMDRMIndividualizationCompleted quando o processamento é concluído. O valor de cada um dos eventos MEWMDRMIndividualizationProgress obtidos chamando IMFMediaEvent::GetValue é um ponteiro IUnknown . Você pode chamar o método QueryInterface da interface IUnknown recuperada para obter uma instância da interface IWMDRMIndividualizationStatus .

Para atualizar as listas de revogação (sinalizador definido como WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH), um evento MEWMDRMREvocationDownloadCompleted é gerado quando o processamento é concluído.

Observação

Quando PerformSecurityUpdate conclui a individualização, os únicos objetos existentes que refletirão o novo estado individualizado são aqueles que herdam de IWMDRMSecurity. Todos os outros objetos existentes não serão atualizados. Você deve liberar e recriar quaisquer outros objetos para que eles reflitam o novo estado individualizado.

Para obter mais informações sobre como usar os métodos assíncronos das APIs Estendidas do Cliente DRM do Windows Media, consulte Usando o Modelo de Evento do Media Foundation.

Requisitos

Requisito	Valor
parâmetro	Wmdrmsdk.h
Biblioteca	Wmdrmsdk.lib

Confira também

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

Exemplo de individualização de DRM

IWMDRMSecurity Interface

Executando a individualização do DRM