Metodo IWMDRMLicenseQuery::QueryActionAllowed
[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 QueryActionAllowed esegue una query nell'archivio licenze locale per recuperare lo stato della licenza per una o più azioni DRM che si applicano a un ID chiave specificato.
Sintassi
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
Parametri
-
bstrKID [in]
-
ID chiave per cui eseguire una query. Verranno valutate solo le licenze applicabili a questo ID chiave.
-
bstrMinReqIndivVersion [in]
-
Versione di sicurezza minima specificata nell'intestazione del file ASF. Questo parametro è facoltativo e, Passare NULL per eseguire la query senza queste informazioni.
-
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 rgdwQueryResult .
-
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_ActionAllowed_Playback Includi per eseguire una query per il diritto di riprodurre il contenuto. g_wszWMDRM_ActionAllowed_Copy Includi per richiedere il diritto di copiare il contenuto in dispositivi o supporti esterni. g_wszWMDRM_ActionAllowed_PlaylistBurn Includi per richiedere il diritto di copiare il contenuto in CD come parte di una playlist. g_wszWMDRM_ActionAllowed_CreateThumbnailImage Includi per eseguire una query per ottenere il diritto di creare un'immagine di anteprima dal contenuto. g_wszWMDRM_ActionAllowed_CopyToCD Includere per richiedere il diritto di copiare il contenuto in CD. -
rgdwQueryResult[] [out]
-
Matrice di una o più variabili DWORD che ricevono i risultati della query per i diritti specificati da rgbstrActionsToQuery. Se è consentita un'azione, l'elemento corrispondente viene impostato su zero. Se un'azione non è consentita, l'elemento viene impostato su uno o più valori dell'enumerazione DRM_ACTION_ALLOWED_QUERY_RESULTS combinata tramite l'operazione OR bit per bit. Questa matrice deve contenere tutti gli elementi specificati da cActionsToQuery.
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
Quando si eseguono query per i diritti di riproduzione e copia, si otterranno risultati più accurati impostando prima i parametri ambientali. Utilizzare il metodo SetActionAllowedQueryParams per impostare i parametri ambientali. I risultati delle query per il diritto di burn-right non sono interessati dai parametri ambientali; è possibile usare in modo sicuro le impostazioni predefinite.
I risultati restituiti dal metodo QueryActionAllowed vengono aggregati da zero o più licenze nell'archivio licenze locale. Il metodo potrebbe non cercare tutte le licenze che si applicano all'ID chiave se rileva un risultato abilitato.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|