Metodo IWMDRMLicenseManagement::BackupLicenses
[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita dal lettore di origine e dal 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 BackupLicenses crea un backup delle licenze nell'archivio licenze locale.
Sintassi
HRESULT BackupLicenses(
[in] BSTR bstrBackupDirectory,
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Parametri
-
bstrBackupDirectory [in]
-
Percorso UNC del percorso in cui verrà eseguito il backup delle licenze.
-
dwFlags [in]
-
Flag che specificano le opzioni di backup da usare. L'unico flag attualmente supportato è WMDRM_BACKUP_OVERWRITE, che configura il metodo per sovrascrivere tutti i file di backup esistenti nella directory.
-
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 valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
Commenti
Questo metodo viene eseguito in modo asincrono. Restituisce immediatamente dopo la chiamata e quindi genera una serie di eventi MEWMDRMLicenseBackupProgress seguiti da un evento MEWMDRMLicenseBackupCompleted al termine dell'elaborazione. Il valore di ogni evento MEWMDRMLicenseBackupProgress ottenuto chiamando IMFMediaEvent::GetValue è un puntatore IUnknown . È possibile chiamare il metodo QueryInterface dell'interfaccia IUnknown recuperata per ottenere un'istanza dell'interfaccia IWMDRMLicenseBackupRestoreStatus .
Per altre informazioni sull'uso dei metodi asincroni delle API estese del client DRM Windows Media, vedere Uso del modello di evento di Media Foundation.
Non è consentito eseguire il backup di tutte le licenze. Questo metodo esegue solo il backup delle licenze che lo consentono.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|