Enumerazione delle licenze nell'archivio licenze locale
[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.
L'enumerazione è un processo di recupero delle informazioni sulle licenze nell'archivio licenze locale, eseguendo un'istruzione alla alla sola. È possibile creare un'enumerazione di licenza chiamando IWMDRMLicenseManagement::CreateLicenseEnumeration.
Il motivo più comune per enumerare le licenze nello Store consiste nel trovare una determinata licenza per la decrittografia di alcuni contenuti.
L'interfaccia IWMDRMLicense funge da portale per i singoli risultati della licenza e come enumeratore. Quando viene creata l'enumerazione della licenza, la prima licenza nell'elenco viene caricata nell'interfaccia IWMDRMLicense . La maggior parte dei metodi di IWMDRMLicense consente di ottenere informazioni sulla licenza o di creare oggetti per crittografare o decrittografare il contenuto in base alla licenza. Esistono tuttavia due metodi che controllano l'enumerazione : GetNext e ResetEnumeration. GetNext carica la licenza successiva nell'elenco nell'interfaccia . ResetEnumeration restituisce l'enumerazione allo stato in cui è stata creata per la prima volta. Quando l'enumerazione viene reimpostata, la prima licenza nell'elenco viene caricata nuovamente nell'interfaccia IWMDRMLicense .
Dopo aver raggiunto l'ultima licenza nell'elenco, la chiamata successiva a GetNext restituisce ERROR_NO_MORE_ITEMS.
Se l'applicazione esegue un'azione con il contenuto coperto da DRM, è necessario controllare le licenze nell'archivio licenze locale per i diritti e per altri fattori di limitazione, ad esempio i livelli di protezione dell'output (OPLs).
Argomenti correlati