Método IWMDRMLicenseManagement::CleanLicenseStore

[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 CleanLicenseStore remove licenças inutilizáveis do repositório de licenças temporário e desfragmenta o repositório de licenças local para melhorar o desempenho.

Sintaxe

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

Parâmetros

dwFlags [in]

Sinalizadores que especificam as opções de limpeza do repositório de licenças a serem usadas. Defina como uma das constantes na tabela a seguir.

Constante	Descrição
WMDRM_CLEAN_LICENSE_STORE_SYNC	A operação de limpo será executada de forma síncrona. Esse método não retornará até que a operação seja concluída.
WMDRM_CLEAN_LICENSE_STORE_ASYNC	A operação de limpo será executada de forma assíncrona. Esse método retornará imediatamente. Quando a operação for concluída, o evento de mídia MELicenseStoreCleaned será enviado.

ppunkCancelationCookie [out]

Ponteiro que recebe um ponteiro para a interface IUnknown de um objeto que identifica essa chamada assíncrona. Esse ponteiro de interface pode ser usado para cancelar a chamada assíncrona chamando o método IWMDRMEventGenerator::CancelAsyncOperation .

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.
DRM_E_LICENSENOTFOUND	Não há nenhum repositório de licenças temporário no computador cliente.

Comentários

Esse método é executado de forma assíncrona. Ele retorna imediatamente após ser chamado e, em seguida, gera um evento MEWMDRMLicenseStoreCleaned quando o processamento é concluído.

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

IWMDRMLicenseManagement Interface