Fonction DRMGetBoundLicenseAttributeCount (msdrm.h)

Article
08/24/2023

[Le Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par

le client dans Msdrm.dll peut être utilisé dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il peut être modifié ou

non disponible dans les versions suivantes. Utilisez plutôt active Directory Rights Management Services SDK 2.1.

qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]

La fonction DRMGetBoundLicenseAttributeCount récupère le nombre d’occurrences d’un attribut dans une licence.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMGetBoundLicenseAttributeCount(
  [in]  DRMHANDLE hQueryRoot,
  [in]  PWSTR     wszAttribute,
  [out] UINT      *pcAttributes
);

Paramètres

[in] hQueryRoot

Handle vers un objet de licence ou de licence, à partir de DRMGetBoundLicenseObject ou DRMCreateBoundLicense.

[in] wszAttribute

Nom de l’attribut à compter.

[out] pcAttributes

Nombre d’occurrences d’attributs.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles incluent, sans s’y limiter, celles de la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Certains attributs, tels que le nombre maximal d’utilisations, peuvent apparaître dans plusieurs branches d’une licence. Cette méthode retourne le nombre de ces occurrences, afin qu’une application puisse les parcourir pour accéder à une instance particulière à l’aide de DRMGetBoundLicenseAttribute.

Le système Active Directory Rights Management expose une interface orientée objet à la licence XrML sous-jacente. Cette fonction, ainsi que d’autres fonctions DRMGetBoundLicense_xxx , permet à une application de naviguer dans cette structure. Pour plus d’informations, consultez Interrogation des licences.