Metodo IWMDRMLicenseQuery::QueryLicenseState

Articolo
06/21/2023

[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 QueryLicenseState esegue una query sull'archivio licenze locale per informazioni sulla licenza applicabili a un ID chiave per uno o più diritti specifici.

Sintassi

HRESULT QueryLicenseState(
  [in]  BSTR                   bstrKID,
  [in]  DWORD                  cActionsToQuery,
  [in]  BSTR                   rgbstrActionsToQuery[],
  [out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);

Parametri

bstrKID [in]

ID chiave per cui eseguire una query. Verranno valutate solo le licenze applicabili a questo ID chiave.

cActionsToQuery [in]

Numero di azioni per cui eseguire una query. Questo valore deve essere impostato sul numero di elementi nelle matrici passate per i parametri rgbstrActionsToQuery e rgResultStateData .

rgbstrActionsToQuery[] [in]

Matrice di uno o più diritti per cui eseguire una query. Questa matrice deve contenere tutti gli elementi specificati da cActionsToQuery. Ogni elemento deve essere impostato su una delle costanti seguenti.

Costante	Descrizione
g_wszWMDRM_LicenseState_Backup	Includere per eseguire una query sui dettagli sul diritto di eseguire il backup e ripristinare la licenza.
g_wszWMDRM_LicenseState_CollaborativePlay	Includere per richiedere i dettagli sul diritto di condividere il contenuto con un gruppo di utenti come parte di uno scenario di riproduzione collaborativa.
g_wszWMDRM_LicenseState_Copy	Includi per cercare i dettagli sul diritto di copiare il contenuto in dispositivi o supporti esterni.
g_wszWMDRM_LicenseState_CopyToCD	Includere per eseguire una query per ottenere i dettagli sul diritto di copiare il contenuto in CD.
g_wszWMDRM_LicenseState_CopyToNonSDMIDevice	Includere per eseguire una query sui dettagli sul diritto di copiare il contenuto in un dispositivo che non supporta l'iniziativa sdMI (Secure Digital Media Initiative).
g_wszWMDRM_LicenseState_CopyToSDMIDevice	Includere per eseguire una query sui dettagli sul diritto di copiare il contenuto in un dispositivo che supporta SDMI.
g_wszWMDRM_LicenseState_CreateThumbnailImage	Includi per cercare i dettagli sul diritto di creare un'immagine di anteprima dal contenuto.
g_wszWMDRM_LicenseState_Playback	Includere per eseguire una query per ottenere i dettagli sul diritto di riprodurre il contenuto.
g_wszWMDRM_LicenseState_PlaylistBurn	Includi per cercare i dettagli sul diritto di copiare il contenuto in CD come parte di una playlist.

rgResultStateData[] [out]

Matrice di una o più strutture DRM_LICENSE_STATE_DATA che ricevono le informazioni sullo stato della licenza applicabili a destra nell'elemento corrispondente del parametro rgbstrActionsToQuery .

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
S_OK	Il metodo è riuscito.

Commenti

Tutte le licenze che si applicano all'ID chiave specificato verranno cercate e valutate. I risultati vengono aggregati, pertanto ogni struttura DRM_LICENSE_STATE_DATA può contenere informazioni da più licenze.

Requisiti

Requisito	Valore
Intestazione	Wmdrmsdk.h
Libreria	Wmdrmsdk.lib

Vedi anche

Interfaccia IWMDRMLicenseQuery

Condividi tramite