Méthode IWMDRMLicenseQuery::QueryLicenseState

[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 le lecteur source et l’enregistreurré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 QueryLicenseState interroge le magasin de licences local pour obtenir des 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 [in]

ID de clé pour laquelle interroger. Seules les licences qui s’appliquent à cet ID de clé seront évaluées.

cActionsToQuery [in]

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[] [in]

Tableau d’un ou plusieurs droits pour lesquels effectuer une requête. 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_LicenseState_Backup	Inclure pour interroger les détails sur le droit de sauvegarde et de restauration de la licence.
g_wszWMDRM_LicenseState_CollaborativePlay	Inclure pour interroger 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.
g_wszWMDRM_LicenseState_Copy	Inclure pour demander des détails sur le droit de copier le contenu sur des appareils ou des médias externes.
g_wszWMDRM_LicenseState_CopyToCD	Inclure pour demander des détails sur le droit de copier le contenu sur CD.
g_wszWMDRM_LicenseState_CopyToNonSDMIDevice	Inclure pour demander des détails sur le droit de copier le contenu sur un appareil qui ne prend pas en charge l’initiative SDMI (Secure Digital Media Initiative).
g_wszWMDRM_LicenseState_CopyToSDMIDevice	Inclure pour interroger les détails sur le droit de copier le contenu sur un appareil qui prend en charge le SDMI.
g_wszWMDRM_LicenseState_CreateThumbnailImage	Inclure pour interroger les détails sur le droit de créer une image miniature à partir du contenu.
g_wszWMDRM_LicenseState_Playback	Inclure pour demander des détails sur le droit de lire le contenu.
g_wszWMDRM_LicenseState_PlaylistBurn	Inclure pour interroger les détails sur le droit de copier le contenu sur CD dans le cadre d’une playlist.

rgResultStateData[] [out]

Tableau d’une ou plusieurs structures DRM_LICENSE_STATE_DATA qui reçoivent les informations d’état de licence qui s’appliquent à la droite dans l’élément correspondant du paramètre rgbstrActionsToQuery .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Notes

Toutes les licences qui s’appliquent à l’ID de clé spécifié feront l’objet d’une recherche et d’une évaluation. Les résultats étant agrégés, chaque structure DRM_LICENSE_STATE_DATA peut contenir des informations provenant de plusieurs licences.

Configuration requise

Voir aussi

IWMDRMLicenseQuery, interface