Fonction DRMGetBoundLicenseAttribute (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 DRMGetBoundLicenseAttribute récupère un attribut de licence lié à partir de la licence XrML.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMGetBoundLicenseAttribute(
  [in]      DRMHANDLE       hQueryRoot,
  [in]      PWSTR           wszAttribute,
  [in]      UINT            iWhich,
  [out]     DRMENCODINGTYPE *peEncoding,
  [in, out] UINT            *pcBuffer,
  [out]     BYTE            *pbBuffer
);

Paramètres

[in] hQueryRoot

Handle vers un objet de requête racine, à partir d’un appel précédent à cette fonction ou de DRMCreateBoundLicense.

[in] wszAttribute

Attribut à récupérer.

[in] iWhich

Index de base zéro de l’occurrence à récupérer.

[out] peEncoding

Type d’encodage utilisé.

[in, out] pcBuffer

Taille, en caractères, de l’attribut récupéré plus un pour un caractère null de fin.

[out] pbBuffer

Pointeur vers l’objet d’attribut.

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

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.

Les attributs contiennent des informations sur un objet, telles que son nom, l’heure du problème ou la valeur de référence SKU. Pour obtenir des informations d’attribut, vous devez d’abord déterminer la taille de la mémoire tampon nécessaire pour contenir les informations récupérées en appelant la fonction avec NULL dans la valeur pbBuffer . Si la fonction réussit et retourne une valeur dans pcBuffer, allouez une mémoire tampon correctement dimensionnée à l’aide de cette valeur et appelez à nouveau la fonction, en transmettant à pbBuffer la mémoire tampon allouée pour recevoir la valeur de l’attribut.

Un objet peut avoir plusieurs instances d’un attribut portant le même nom. Par exemple, il peut y avoir plusieurs valeurs de type d’authentificateur dans une licence. Dans ce cas, il peut être nécessaire d’effectuer une itération au sein de toutes les instances d’un attribut en appelant d’abord DRMGetBoundLicenseAttributeCount pour obtenir le nombre d’objets existants, puis en effectuant une boucle dans toutes les instances iWhich de l’attribut, en commençant à zéro et en incrémentant d’un.