Fonction DRMCreateLicenseStorageSession (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 DRMCreateLicenseStorageSession crée une session de stockage de licence, qui est nécessaire pour acquérir ou manipuler une licence.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMCreateLicenseStorageSession(
  [in]  DRMENVHANDLE hEnv,
  [in]  DRMHANDLE    hDefaultLibrary,
  [in]  DRMHSESSION  hClient,
  [in]  UINT         uFlags,
  [in]  PWSTR        wszIssuanceLicense,
  [out] DRMHSESSION  *phLicenseStorage
);

Paramètres

[in] hEnv

Handle pour l’environnement AD RMS. Ce handle est obtenu à l’aide de la fonction DRMInitEnvironment .

[in] hDefaultLibrary

Handle de la bibliothèque par défaut. Ce handle est obtenu à l’aide de la fonction DRMInitEnvironment .

[in] hClient

Handle pour une session cliente. Ce handle est obtenu à l’aide de la fonction DRMCreateClientSession .

[in] uFlags

Ce paramètre est réservé et doit être défini sur zéro.

[in] wszIssuanceLicense

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient une licence d’émission signée. La session de stockage de licence créée est associée à cette licence d’émission.

[out] phLicenseStorage

Pointeur vers un handle qui reçoit le handle de session de stockage de licence. Ce handle doit être passé à la fonction DRMCloseSession lorsque la session de stockage de licence n’est plus nécessaire.

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. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Une session de stockage de licences est utilisée pour acquérir, supprimer et énumérer des licences, entre autres utilisations. Pour établir une liaison avec une licence et exercer ses droits, une application doit utiliser DRMCreateBoundLicense.

Le handle d’environnement et le handle de bibliothèque par défaut sont créés à l’aide de DRMInitEnvironment.

Le handle retourné dans le paramètre phLicenseStorage doit être passé à la fonction DRMCloseSession lorsque la session de stockage de licence n’est plus nécessaire.