Fonction DRMGetBoundLicenseObject (msdrm.h)

Article
03/04/2024

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

le client dans Msdrm.dll est disponible 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 DRMGetBoundLicenseObject retourne un objet à partir d’une licence liée.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMGetBoundLicenseObject(
  [in]  DRMHANDLE hQueryRoot,
  [in]  PWSTR     wszSubObjectType,
  [in]  UINT      iWhich,
  [out] DRMHANDLE *phSubObject
);

Paramètres

[in] hQueryRoot

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

[in] wszSubObjectType

Type d’objet XrML à rechercher. Pour plus d'informations, consultez la section Notes.

[in] iWhich

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

[out] phSubObject

Handle de l’objet de licence retourné. Appelez DRMCloseHandle pour fermer le handle.

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.

Remarques

Il existe de nombreux types d’objets dans une licence, tels que les principaux, les droits et les conditions d’accès. 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. Lors du premier appel, utilisez le handle de licence lui-même comme racine de la requête.

Lors du premier appel, cette fonction prend le DRMHANDLE retourné par DRMCreateBoundLicense.

Le paramètre wszSubObjectType identifie un type XrML, comme illustré dans l’exemple suivant. L’utilisation de g_wszQUERY_OBJECTTYPE pour interroger le XrML retourne « Licence d’identité de groupe ».

<PRINCIPAL internal-id="1">
  <OBJECT type="Group Identity Licensor">
  <ID type="Group Identity">someone@example.com</ID> 
  <NAME>Pavel's Group Identity</NAME> 
  </OBJECT>

Appelez DRMCloseHandle pour fermer le handle créé en appelant cette fonction.