Método IWMDRMLicenseManagement::RestoreLicenses

[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 RestoreLicenses restaura las licencias de una copia de seguridad de licencias que se creó mediante una llamada al método BackupLicenses .

Sintaxis

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

Parámetros

bstrBackupDirectory [in]

Ruta de acceso UNC de la ubicación desde la que se restaurarán las licencias.

dwFlags [in]

Marcas que especifican las opciones de restauración que se van a usar. La única marca admitida actualmente es WMDRM_RESTORE_INDIVIDUALIZE, que configura el método para realizar la individualización como parte de la restauración, si es necesario.

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 MEWMDRMLicenseRestoreProgress seguidos de un evento MEWMDRMLicenseRestoreCompleted cuando se completa el procesamiento. El valor de cada uno de los eventos MEWMDRMLicenseRestoreProgress obtenidos mediante una llamada 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.

La copia de seguridad puede ser desde la máquina local o desde otra máquina.

Requisitos

Requisito	Value
Encabezado	Wmdrmsdk.h
Biblioteca	Wmdrmsdk.lib

Consulte también

IWMDRMLicenseManagement (Interfaz)