IWMDRMLicenseQuery :: QueryLicenseState, méthode
La méthode QueryLicenseState interroge le magasin de licences local pour obtenir les informations de licence qui s’appliquent à un ID de clé pour un ou plusieurs droits spécifiques.
Syntaxe
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
Paramètres
-
bstrKID [ dans]
-
ID de clé à interroger. Seules les licences qui s’appliquent à cet ID de clé sont évaluées.
-
cActionsToQuery [ dans]
-
Nombre d’actions à interroger. Cette valeur doit être définie sur le nombre d’éléments dans les tableaux passés pour les paramètres rgbstrActionsToQuery et rgResultStateData .
-
[ rgbstrActionsToQuery ] [dans]
-
Tableau d’un ou de plusieurs droits à interroger. Ce tableau doit contenir autant d’éléments que ce qui est spécifié par cActionsToQuery. Chaque élément doit être défini sur l’une des constantes suivantes.
Constante Description c _ wszWMDRM _ LicenseState _ sauvegarde Incluez pour demander les détails sur le droit de sauvegarder et de restaurer la licence. g _ wszWMDRM _ LicenseState _ CollaborativePlay Incluez pour demander les détails sur le droit de partager le contenu avec un groupe d’utilisateurs dans le cadre d’un scénario de lecture collaborative. _wszWMDRM g _ LicenseState _ copie Include pour rechercher les détails sur le droit de copier le contenu vers des périphériques ou des médias externes. g _ wszWMDRM _ LicenseState _ CopyToCD Incluez pour demander les détails sur le droit de copier le contenu sur CD. g _ wszWMDRM _ LicenseState _ CopyToNonSDMIDevice Incluez pour demander les détails sur le droit de copier le contenu sur un appareil qui ne prend pas en charge l’initiative de support numérique sécurisé (SDMI). g _ wszWMDRM _ LicenseState _ CopyToSDMIDevice Inclure pour demander les détails sur le droit de copier le contenu sur un appareil qui prend en charge le périphérique SDMI. g _ wszWMDRM _ LicenseState _ CreateThumbnailImage Include pour rechercher les détails sur le droit de créer une image miniature à partir du contenu. _lecture wszWMDRM _ LicenseState _ g Include pour rechercher les détails sur le droit de lire le contenu. g _ wszWMDRM _ LicenseState _ PlaylistBurn Inclure pour demander les détails sur le droit de copier le contenu sur CD dans le cadre d’une sélection. -
[ rgResultStateData ] en [ sortie]
-
Tableau d’une ou de plusieurs structures de données d' _ État de licence _ _ DRM qui reçoivent les informations d’état de licence qui s’appliquent à droite dans l’élément correspondant du paramètre rgbstrActionsToQuery .
Valeur de retour
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
Toutes les licences qui s’appliquent à l’ID de clé spécifié seront recherchées et évaluées. Les résultats sont agrégés, de sorte que chaque structure de _ données d' _ état _ de licence DRM peut contenir des informations provenant de plusieurs licences.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|