Structure DRM_LICENSE_STATE_DATA (Drmexternals. h)

La structure des données d’état de _ licence _ _ DRM contient des informations de licence sur un droit DRM spécifié.

Syntaxe

typedef struct DRM_LICENSE_STATE_DATA {
  DWORD                      dwStreamId;
  DRM_LICENSE_STATE_CATEGORY dwCategory;
  DWORD                      dwNumCounts;
  DWORD                      dwCount[4];
  DWORD                      dwNumDates;
  FILETIME                   datetime[4];
  DWORD                      dwVague;
} ;

Membres

dwStreamId

Numéro de flux auquel la licence s’applique. Doit avoir la valeur 0, ce qui indique que la licence s’applique à tous les flux du fichier.

dwCategory

Catégorie de chaîne à afficher. Consultez _ catégorie d' _ état _ de licence DRM pour connaître les valeurs possibles et leur signification.

dwNumCounts

Nombre d’éléments fournis dans dwCount. Cette valeur est généralement 0 ou 1.

dwCount [ 4]

Tableau de 0 ou 1 ou plusieurs DWORD s qui représentent le nombre de fois que l’action spécifiée dans dwCategory peut être exécutée. Consultez la section Remarques.

dwNumDates

Nombre d’éléments fournis dans DateTime. En règle générale, il n’est pas possible d’utiliser plus de deux dates, par exemple avec une licence valide à partir d’une date jusqu’à une autre date.

DATEHEURE [ 4]

Tableau d’une ou de plusieurs structures FILETIME représentant une ou plusieurs dates dans la licence. La signification d’une date particulière dépend de la valeur de dwCategory.

dwVague

Zéro, un ou plusieurs des indicateurs suivants combinés avec une opération or au niveau du bit :

Indicateur Description
données d’état de la _ licence DRM _ _ _ vague Si cette valeur est définie, il peut y avoir plus de licences qui s’appliquent au contenu.
_OPL de données d’état de licence DRM _ _ _ _ présent Si cette option est définie, la licence comprend des niveaux de protection de sortie (OPLs) qui doivent être récupérés et vérifiés par rapport à la destination de la sortie de votre application.
données d’état de la _ licence DRM _ _ _ _ présentes S’il est défini, le contenu doit être remis à l’aide d’un chemin d’accès audio sécurisé (SAP).

Remarques

Cette structure est retournée (encapsulée dans une structure de _ données d' _ état _ de licence WM ) à partir d’un appel à IWMDRMReader :: GetDRMProperty lorsque vous spécifiez l’une des propriétés d’état de licence DRM. Ces propriétés sont :

Si dwCategory est le _ _ _ nombre d’États de licence WM DRM _ _ de _ until, le tableau DateTime contient généralement deux dates, une date « from » et une date « until ». Il est également possible de spécifier deux paires de dates pour créer des licences plus complexes.

Les éléments du tableau dwCount correspondent aux dates ou aux plages de dates spécifiées dans le tableau DateTime . Si dwCategory est le _ _ _ nombre d’États de licence WM DRM _ _ de _ until et que DateTime contient une paire de dates, dwCount contient un élément. Si DateTime contient deux paires de dates (quatre éléments), dwCount doit contenir deux éléments, un pour chaque paire de dates.

Dans certains cas, les utilisateurs ont peut-être émis plus d’une licence pour un fichier. Par exemple, ils peuvent avoir acquis une licence qui a autorisé cinq lectures jusqu’à la fin du mois et acquis ultérieurement une deuxième licence pour des droits illimités. Dans ce cas, l’indicateur de _ données de l' _ État de licence DRM _ _ est défini dans dwVague ( dwVague & DRM_LICENSE_STATE_DATA_VAGUE != 0 ) et le composant DRM utilise un algorithme pour déterminer l’ensemble de droits le plus probable qui ont été appliqués. Lorsqu’une licence expire, le composant DRM examine les licences restantes, et ainsi de suite jusqu’à ce que toutes les licences aient expiré.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
Version
Windows Media Format 7 SDK ou les versions ultérieures du kit de développement logiciel (SDK)
En-tête
Drmexternals. h

Voir aussi

Structures