Método IWMDRMLicenseManagement::RestoreLicenses
[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 RestoreLicenses restaura licenças de um backup de licença que foi criado chamando o método BackupLicenses .
Sintaxe
HRESULT RestoreLicenses(
[in] BSTR bstrBackupDirectory,
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Parâmetros
-
bstrBackupDirectory [in]
-
Caminho UNC do local do qual as licenças serão restauradas.
-
dwFlags [in]
-
Sinalizadores que especificam as opções de restauração a serem usadas. O único sinalizador com suporte no momento é WMDRM_RESTORE_INDIVIDUALIZE, que configura o método para executar a individualização como parte da restauração, se necessá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 |
|---|---|
|
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 MEWMDRMLicenseRestoreProgress seguidos por um evento MEWMDRMLicenseRestoreCompleted quando o processamento é concluído. O valor de cada um dos eventos MEWMDRMLicenseRestoreProgress 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.
O backup pode ser do computador local ou de um computador diferente.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|