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 |