Fonction DRMCloseHandle (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 DRMCloseHandle ferme les handles aux objets créés avec les fonctions DRMCreate* et les bibliothèques chargées à l’aide de DRMLoadLibrary.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMCloseHandle(
  [in] DRMHANDLE handle
);

Paramètres

[in] handle

Handle à fermer.

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.

Notes

Cette fonction efface correctement les données sensibles de la mémoire et permet au système AD RMS de conserver un nombre de références précis sur les objets utilisés. Si un objet contient d’autres objets ouverts, l’appel de cette fonction force également la fermeture de tous les objets contenus. Toutefois, il n’est pas recommandé de forcer la fermeture d’objets contenus de cette façon.

Si cette fonction échoue, une application doit détruire le processus en cours après la fermeture de l’environnement avec DRMCloseEnvironmentHandle.

La fermeture d’un handle à une bibliothèque entraîne le déchargement de la bibliothèque si elle n’a pas d’objets ouverts restants.

Spécifications

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

Voir aussi

Fonctions AD RMS

Handles et sessions AD RMS