Método IWMDRMDeviceApp::SynchronizeLicenses

O método SynchronizeLicenses atualiza as licenças em um dispositivo quando elas estão perto de expirar.

Sintaxe

HRESULT SynchronizeLicenses(
  [in] IWMDMDevice    *pDevice,
  [in] IWMDMProgress3 *pProgressCallback,
  [in] DWORD          cMinCountThreshold,
  [in] DWORD          cMinHoursThreshold
);

Parâmetros

pDevice [in]

Ponteiro para um objeto IWMDMDevice .

pProgressCallback [in]

Retorno de chamada de progresso que receberá o progresso de todas as etapas que talvez precisem ser realizadas. A etapa é identificada pelo parâmetro EventId do método IWMDMProgress3 chamado.

cMinCountThreshold [in]

Contagem mínima de reprodução restante opcional em uma licença de dispositivo.

cMinHoursThreshold [in]

Horas mínimas restantes opcionais em uma licença de dispositivo.

Valor retornado

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_INVALIDARG	Um ou mais argumentos não são válidos.
DRM_E_INVALIDXMLTAG	XML é formado incorretamente.
DRM_E_NOTIMPL	Essa funcionalidade não está implementada no momento. (SyncLicenses w/ pDevice =NULL)
DRM_E_NOXMLCLOSETAG	O XML de licença foi formado incorretamente.
DRM_E_NOXMLOPENTAG	O XML de licença foi formado incorretamente.
DRM_E_OUTOFMEMORY	Sem memória.
DRM_E_XMLNOTFOUND	Falha ao localizar uma marca XML necessária na licença.
NS_E_DEVICE_NOT_WMDRM_DEVICE	O dispositivo especificado não é um dispositivo compatível com DRM do Windows Media.
NS_E_DRM_NEEDS_INDIVIDUALIZATION	O DRM requer uma caixa preta individualizada para executar essa função. Em outras palavras, o SDK de Formato de Mídia do Windows requer uma atualização de segurança.

Comentários

Essa chamada só pode ser feita em um dispositivo que dá suporte ao DRM 10 do Windows Media para Dispositivos Portáteis. Você deve especificar pelo menos um parâmetro de limite.

Requisitos

Requisito	Valor
parâmetro	WMDRMDeviceApp.h (também requer Wmdrmdeviceapp_i.c, criado a partir de WMDRMDeviceApp.idl)
Biblioteca	Mssachlp.lib

Confira também

Manipulando conteúdo protegido no aplicativo

IWMDMProgress3 Interface

IWMDRMDeviceApp Interface