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
_OK
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
Wmdrmsdk. h
Bibliothèque
Wmdrmsdk. lib

Voir aussi

Interface IWMDRMLicenseQuery