Méthode IWMDRMLicenseQuery::QueryActionAllowed
[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La méthode QueryActionAllowed effectue une requête sur le magasin de licences local pour récupérer les status de licence pour une ou plusieurs actions DRM qui s’appliquent à un ID de clé spécifié.
Syntaxe
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
Paramètres
-
bstrKID [in]
-
ID de clé pour laquelle interroger. Seules les licences qui s’appliquent à cet ID de clé seront évaluées.
-
bstrMinReqIndivVersion [in]
-
Version de sécurité minimale spécifiée dans l’en-tête du fichier ASF. Ce paramètre est facultatif. Passez la valeur NULL pour exécuter la requête sans ces informations.
-
cActionsToQuery [in]
-
Nombre d’actions pour lesquelles interroger. Cette valeur doit être définie sur le nombre d’éléments dans les tableaux passés pour les paramètres rgbstrActionsToQuery et rgdwQueryResult .
-
rgbstrActionsToQuery[] [in]
-
Tableau d’un ou plusieurs droits pour lesquels l’interrogation doit être effectuée. Ce tableau doit contenir autant d’éléments que spécifié par cActionsToQuery. Chaque élément doit être défini sur l’une des constantes suivantes :
Constant Description g_wszWMDRM_ActionAllowed_Playback Inclure pour demander le droit de lire le contenu. g_wszWMDRM_ActionAllowed_Copy Inclure pour demander le droit de copier le contenu sur des appareils ou des médias externes. g_wszWMDRM_ActionAllowed_PlaylistBurn Inclure pour demander le droit de copier le contenu sur CD dans le cadre d’une playlist. g_wszWMDRM_ActionAllowed_CreateThumbnailImage Inclure pour demander le droit de créer une image miniature à partir du contenu. g_wszWMDRM_ActionAllowed_CopyToCD Inclure pour demander le droit de copier le contenu sur UN CD. -
rgdwQueryResult[] [out]
-
Tableau d’une ou plusieurs variables DWORD qui reçoivent les résultats de la requête pour les droits spécifiés par rgbstrActionsToQuery. Si une action est autorisée, l’élément correspondant est défini sur zéro. Si une action n’est pas autorisée, l’élément est défini sur une ou plusieurs valeurs de l’énumération DRM_ACTION_ALLOWED_QUERY_RESULTS combinées à l’aide de l’opération OR au niveau du bit. Ce tableau doit contenir autant d’éléments que spécifié par cActionsToQuery.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
Notes
Lorsque vous interrogez les droits de lecture et de copie, vous obtiendrez des résultats plus précis en définissant d’abord des paramètres environnementaux. Utilisez la méthode SetActionAllowedQueryParams pour définir les paramètres environnementaux. Les résultats des requêtes pour le droit de gravure ne sont pas affectés par les paramètres environnementaux ; vous pouvez utiliser les valeurs par défaut en toute sécurité.
Les résultats retournés par la méthode QueryActionAllowed sont agrégés à partir de zéro ou plusieurs licences dans le magasin de licences local. La méthode peut ne pas rechercher toutes les licences qui s’appliquent à l’ID de clé si elle rencontre un résultat activé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|