Fonction DRMLoadLibrary (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 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 pour un environnement, créé par DRMInitEnvironment.

[in] eSpecification

Type de fournisseur de bibliothèque.

[in] wszLibraryProvider

Nom et chemin d’accès facultatif à la DLL. Chaque DLL doit avoir un nom unique. Si des DLL nommées de la même façon sont chargées, même si elles 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 d’application chargé par DRMInitEnvironment.

[out] phLibrary

Handle de 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, sans s’y limiter, celles de 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 de LoadLibrary. Pour fermer le handle retourné, appelez DRMCloseHandle, et non FreeLibrary. Par défaut, le répertoire actif est le seul emplacement que cette fonction recherche pour une bibliothèque. Tout autre répertoire doit être spécifié par un chemin d’accès complet ou par 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 les bibliothèques chargées.

Les dépendances de la DLL chargée sont également chargées, à condition qu’elles soient incluses dans les informations d’identification du plug-in et 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.

Note Si une application tente de charger une deuxième bibliothèque avec le nom d’une bibliothèque précédemment chargée, cette nouvelle bibliothèque ne sera pas vérifiée par rapport au manifeste, même si elle provient d’un chemin d’accès différent. Utilisez uniquement des bibliothèques nommées de manière unique pour éviter ce contournement de la vérification du manifeste.

 

Configuration requise

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

Voir aussi

Fonctions AD RMS

DRMGetProcAddress