Método IWMDRMLicenseManagement::BackupLicenses

[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 BackupLicenses cria um backup das licenças no repositório de licenças local.

Sintaxe

HRESULT BackupLicenses(
  [in]  BSTR     bstrBackupDirectory,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parâmetros

bstrBackupDirectory [in]

Caminho UNC do local para o qual as licenças serão copiadas em backup.

dwFlags [in]

Sinalizadores que especificam as opções de backup a serem usadas. O único sinalizador com suporte no momento é WMDRM_BACKUP_OVERWRITE, que configura o método para substituir todos os arquivos de backup existentes no diretório.

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.

Comentários

Esse método é executado de forma assíncrona. Ele retorna imediatamente após ser chamado e, em seguida, gera uma série de eventos MEWMDRMLicenseBackupProgress seguidos por um evento MEWMDRMLicenseBackupCompleted quando o processamento é concluído. O valor de cada um dos eventos MEWMDRMLicenseBackupProgress 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 IWMDRMLicenseBackupRestoreStatus .

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.

Nem todas as licenças têm permissão para serem copiadas em backup. Esse método só faz backup de licenças que permitem isso.

Requisitos

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

Confira também

IWMDRMLicenseManagement Interface