DRMLoadLibrary, fonction (msdrm.h)
[Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par
le client dans Msdrm.dll est disponible pour une utilisation 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. Au lieu de cela, utilisez le Kit de développement logiciel (SDK) Active Directory Rights Management Services 2.1,
qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]
La fonction DRMLoadLibrary charge un handle dans une bibliothèque approuvée, comme déterminé par les informations d’identification.
Syntaxe
DRMEXPORT HRESULT UDAPICALL DRMLoadLibrary(
[in] DRMENVHANDLE hEnv,
[in] DRMSPECTYPE eSpecification,
[in] PWSTR wszLibraryProvider,
[in] PWSTR wszCredentials,
[out] DRMHANDLE *phLibrary
);
Paramètres
[in] hEnv
Handle vers un environnement, créé par DRMInitEnvironment.
[in] eSpecification
Type de fournisseur de bibliothèque.
[in] wszLibraryProvider
Nom et chemin facultatif vers la DLL. Chaque DLL doit avoir un nom unique. Si des DLL nommées de même nom sont chargées, même s’ils se trouvent dans des chemins différents, seul le premier élément est inclus dans le manifeste et vérifié.
[in] wszCredentials
Réservé, doit être NULL. La DLL chargée doit être référencée dans le manifeste de l’application chargé par DRMInitEnvironment.
[out] phLibrary
Handle vers la bibliothèque.
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, mais ne sont pas limitées à celles figurant dans la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
Cette fonction est une version sécurisée de la fonction LoadLibrary , mais elle ne prend pas en charge les options supplémentaires de LoadLibraryEx. Le handle retourné correspond à la sortie HMODULE par LoadLibrary. Pour fermer le handle retourné, appelez DRMCloseHandle, pas FreeLibrary. Par défaut, le répertoire actuel est le seul emplacement où cette fonction recherche une bibliothèque. Tout autre répertoire doit être spécifié par un chemin complet ou un chemin relatif au répertoire actif. Utilisez DRMGetProcAddress, la version sécurisée de la fonction GetProcAddress pour obtenir des adresses de fonction dans des bibliothèques chargées.
Les dépendances de la DLL chargée seront également chargées, à condition qu’elles soient incluses dans les informations d’identification du plug-in et qu’elles soient correctement signées. Si la DLL a déjà été chargée, la fonction retourne S_OK et retourne un pointeur vers le même handle.
Configuration requise
| Plateforme cible | Windows |
| En-tête | msdrm.h |
| Bibliothèque | Msdrm.lib |
| DLL | Msdrm.dll |