Método IWMDRMLicenseManagement::BackupLicenses

[La característica asociada a esta página, WINDOWS Media Format 11 SDK, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector fuente y escritor receptor en lugar del SDK de Windows Media Format 11, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método BackupLicenses crea una copia de seguridad de las licencias en el almacén de licencias local.

Sintaxis

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

Parámetros

bstrBackupDirectory [in]

Ruta de acceso UNC de la ubicación en la que se realizará la copia de seguridad de las licencias.

dwFlags [in]

Marcas que especifican las opciones de copia de seguridad que se van a usar. La única marca admitida actualmente es WMDRM_BACKUP_OVERWRITE, que configura el método para sobrescribir los archivos de copia de seguridad existentes en el directorio.

ppunkCancelationCookie [out]

Puntero que recibe un puntero a la interfaz IUnknown de un objeto que identifica esta llamada asincrónica. Este puntero de interfaz se puede usar para cancelar la llamada asincrónica llamando al método IWMDRMEventGenerator::CancelAsyncOperation .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Observaciones

Este método se ejecuta de forma asincrónica. Devuelve inmediatamente después de llamar a y, a continuación, genera una serie de eventos MEWMDRMLicenseBackupProgress seguidos de un evento MEWMDRMLicenseBackupCompleted cuando se completa el procesamiento. El valor de cada uno de los eventos MEWMDRMLicenseBackupProgress obtenidos llamando a IMFMediaEvent::GetValue es un puntero IUnknown . Puede llamar al método QueryInterface de la interfaz IUnknown recuperada para obtener una instancia de la interfaz IWMDRMLicenseBackupRestoreStatus .

Para obtener más información sobre el uso de los métodos asincrónicos de las API extendidas del cliente DRM de Windows Media, consulte Uso del modelo de eventos de Media Foundation.

No se permite realizar una copia de seguridad de todas las licencias. Este método solo realiza una copia de seguridad de las licencias que lo permiten.

Requisitos

Requisito	Value
Encabezado	Wmdrmsdk.h
Biblioteca	Wmdrmsdk.lib

Consulte también

IWMDRMLicenseManagement (Interfaz)