Condividi tramite


Metodo IWMDRMLicenseManagement::CleanLicenseStore

[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e Writer sink. Lettore di origine e Writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di origine e Writer sink anziché Windows Media Format 11 SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo CleanLicenseStore rimuove le licenze inutilizzabili dall'archivio licenze temporanee e deframmenta l'archivio licenze locale per migliorare le prestazioni.

Sintassi

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

Parametri

dwFlags [in]

Flag che specificano le opzioni di pulizia dell'archivio licenze da usare. Impostare su una delle costanti nella tabella seguente.

Costante Descrizione
WMDRM_CLEAN_LICENSE_STORE_SYNC L'operazione di pulizia verrà eseguita in modo sincrono. Questo metodo non restituirà fino al completamento dell'operazione.
WMDRM_CLEAN_LICENSE_STORE_ASYNC L'operazione di pulizia verrà eseguita in modo asincrono. Questo metodo restituirà immediatamente. Al termine dell'operazione, verrà inviato l'evento multimediale MELicenseStoreCleaned.

ppunkCancelationCookie [out]

Puntatore che riceve un puntatore all'interfaccia IUnknown di un oggetto che identifica questa chiamata asincrona. Questo puntatore di interfaccia può essere usato per annullare la chiamata asincrona chiamando il metodo IWMDRMEventGenerator::CancelAsyncOperation .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
DRM_E_LICENSENOTFOUND
Nel computer client non è presente alcun archivio licenze temporanee.

Commenti

Questo metodo viene eseguito in modo asincrono. Restituisce immediatamente dopo essere stato chiamato e quindi genera un evento MEWMDRMLicenseStoreCleaned al termine dell'elaborazione.

Per altre informazioni sull'uso dei metodi asincroni delle API estese del client DRM Windows Media, vedere Uso del modello di evento Media Foundation.

Requisiti

Requisito Valore
Intestazione
Wmdrmsdk.h
Libreria
Wmdrmsdk.lib

Vedi anche

Interfaccia IWMDRMLicenseManagement