AddDllDirectory, fonction (libloaderapi.h)

  • Article

Ajoute un répertoire au chemin de recherche dll de processus.

Syntaxe

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Paramètres

[in] NewDirectory

Chemin d’accès absolu au répertoire à ajouter au chemin de recherche. Par exemple, pour ajouter le répertoire Dir2 au chemin de recherche de la DLL de processus, spécifiez \Dir2. Pour plus d’informations sur les chemins d’accès, consultez Naming Files, Paths, and Namespaces.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur opaque qui peut être passé à RemoveDllDirectory pour supprimer la DLL du chemin de recherche de la DLL de processus.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction AddDllDirectory peut être utilisée pour ajouter n’importe quel chemin d’accès absolu à l’ensemble des répertoires recherchés pour une DLL. Si SetDefaultDllDirectories est d’abord appelé avec LOAD_LIBRARY_SEARCH_USER_DIRS, les répertoires spécifiés avec AddDllDirectory sont ajoutés au chemin de recherche de la DLL de processus. Sinon, les répertoires spécifiés avec la fonction AddDllDirectory sont utilisés uniquement pour les appels de fonction LoadLibraryEx qui spécifient LOAD_LIBRARY_SEARCH_USER_DIRS.

Si AddDllDirectory est utilisé pour ajouter plusieurs répertoires au chemin de recherche dll de processus, l’ordre dans lequel ces répertoires sont recherchés n’est pas spécifié.

Pour supprimer un répertoire ajouté avec AddDllDirectory, utilisez la fonction RemoveDllDirectory .

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Pour utiliser cette fonction dans une application, appelez GetProcAddress pour récupérer l’adresse de la fonction à partir de Kernel32.dll. KB2533623 doivent être installés sur la plateforme cible.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement],KB2533623 sur Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête libloaderapi.h (inclure Windows.h)
DLL Kernel32.dll