Fonction DRMGetOwnerLicense (msdrm.h)

[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 DRMGetOwnerLicense récupère une licence propriétaire créée en appelant DRMGetSignedIssuanceLicense.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMGetOwnerLicense(
  [in]      DRMPUBHANDLE hIssuanceLicense,
  [in, out] UINT         *puOwnerLicenseLength,
  [out]     PWSTR        wszOwnerLicense
);

Paramètres

[in] hIssuanceLicense

Handle d’une licence d’émission signée.

[in, out] puOwnerLicenseLength

Entier non signé qui contient la longueur, en caractères, de la licence propriétaire récupérée par cette fonction. Le caractère null de fin est inclus dans la longueur.

[out] wszOwnerLicense

Chaîne terminée par null qui contient la licence propriétaire au format XrML. Par exemple, licence propriétaire XrML, consultez Exemple XML de licence propriétaire.

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

Une licence propriétaire est une licence d’utilisateur final qui contient le droit PROPRIÉTAIRE et permet à l’utilisateur d’exercer tous les droits, qu’ils soient spécifiquement accordés ou non. Il est créé par le client AD RMS lorsque vous appelez DRMGetSignedIssuanceLicense et que vous signez une licence d’émission hors connexion. Si DRMGetSignedIssuanceLicense est appelé avec le paramètre uFlags défini sur DRM_OWNER_LICENSE_NOPERSIST, la licence propriétaire est enregistrée en mémoire. Sinon, il est enregistré dans le magasin de licences. La fonction DRMGetOwnerLicense récupère automatiquement la licence à partir de l’un ou l’autre emplacement.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	msdrm.h
Bibliothèque	Msdrm.lib
DLL	Msdrm.dll

Voir aussi

DRMGetSignedIssuanceLicense