Metodo IWMDRMSecurity::P erformSecurityUpdate
[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 PerformSecurityUpdate avvia un aggiornamento della sicurezza al sottosistema DRM nel computer locale.
Sintassi
HRESULT PerformSecurityUpdate(
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Parametri
-
dwFlags [in]
-
Opzione di aggiornamento espressa come uno dei flag seguenti.
Flag Descrizione WMDRM_SECURITY_PERFORM_INDIV Determina l'individualizzazione del componente DRM solo se la versione del client non è aggiornata. WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH Determina l'aggiornamento degli elenchi di revoche nel computer client. WMDRM_SECURITY_PERFORM_FORCE_INDIV Determina l'individualizzazione del componente DRM anche se la versione del client è aggiornata. -
ppunkCancelationCookie [out]
-
Indirizzo di una variabile che riceve un puntatore a un oggetto che può essere utilizzato per annullare questa operazione.
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 eventi a seconda del flag impostato nel parametro dwFlags .
Per la individualizzazione (flag impostato su WMDRM_SECURITY_PERFORM_INDIV o WMDRM_SECURITY_PERFORM_FORCE_INDIV), viene generata una serie di eventi MEWMDRMIndividualizationProgress seguiti da un evento MEWMDRMIndividualizationCompleted al termine dell'elaborazione. Il valore di ogni evento MEWMDRMIndividualizationProgress ottenuto chiamando IMFMediaEvent::GetValue è un puntatore IUnknown . È possibile chiamare il metodo QueryInterface dell'interfaccia IUnknown recuperata per ottenere un'istanza dell'interfaccia IWMDRMIndividualizationStatus .
Per aggiornare gli elenchi di revoche (flag impostato su WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH), al termine dell'elaborazione viene generato un evento MEWMDRMREvocationDownloadCompleted .
Nota
Quando PerformSecurityUpdate completa l'individualizzazione, gli unici oggetti esistenti che rifletteranno il nuovo stato individualizzato sono quelli che ereditano da IWMDRMSecurity. Tutti gli altri oggetti esistenti non verranno aggiornati. È necessario rilasciare e ricreare qualsiasi altro oggetto in modo che riflettano il nuovo stato individualizzato.
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.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|