Compartir a través de


Método IWMDRMLicenseManagement::CleanLicenseStore

[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 CleanLicenseStore quita las licencias inutilizables del almacén de licencias temporal y desfragmenta el almacén de licencias local para mejorar el rendimiento.

Sintaxis

HRESULT CleanLicenseStore(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parámetros

dwFlags [in]

Marcas que especifican las opciones de limpieza del almacén de licencias que se van a usar. Establezca en una de las constantes de la tabla siguiente.

Constante Descripción
WMDRM_CLEAN_LICENSE_STORE_SYNC La operación limpia se realizará sincrónicamente. Este método no devolverá hasta que se complete la operación.
WMDRM_CLEAN_LICENSE_STORE_ASYNC La operación limpia se realizará de forma asincrónica. Este método se devolverá inmediatamente. Una vez completada la operación, se enviará el evento multimedia MELicenseStoreCleaned.

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.
DRM_E_LICENSENOTFOUND
No hay ningún almacén de licencias temporal en el equipo cliente.

Observaciones

Este método se ejecuta de forma asincrónica. Devuelve inmediatamente después de llamar a y, a continuación, genera un evento MEWMDRMLicenseStoreCleaned cuando se completa el procesamiento.

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.

Requisitos

Requisito Value
Encabezado
Wmdrmsdk.h
Biblioteca
Wmdrmsdk.lib

Consulte también

IWMDRMLicenseManagement (Interfaz)