Metodo IWMDRMLicenseManagement::RestoreLicenses
[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 RestoreLicenses ripristina le licenze da un backup della licenza creato chiamando il metodo BackupLicenses .
Sintassi
HRESULT RestoreLicenses(
[in] BSTR bstrBackupDirectory,
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Parametri
-
bstrBackupDirectory [in]
-
Percorso UNC del percorso da cui verranno ripristinate le licenze.
-
dwFlags [in]
-
Flag che specificano le opzioni di ripristino da usare. L'unico flag attualmente supportato è WMDRM_RESTORE_INDIVIDUALIZE, che configura il metodo per eseguire l'individualizzazione come parte del ripristino, se necessario.
-
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 MEWMDRMLicenseRestoreProgress seguiti da un evento MEWMDRMLicenseRestoreCompleted al termine dell'elaborazione. Il valore di ogni evento MEWMDRMLicenseRestoreProgress 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.
Il backup può essere dal computer locale o da un computer diverso.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|