AddDllDirectory, fonction (libloaderapi.h)

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

Syntaxe

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Paramètres

[in] NewDirectory

Chemin absolu du répertoire à ajouter au chemin de recherche. Par exemple, pour ajouter le répertoire Dir2 au chemin de recherche dll de processus, spécifiez \Dir2. Pour plus d’informations sur les chemins d’accès, consultez Noms de fichiers, chemins et espaces de noms.

Valeur retournée

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

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

Remarques

La fonction AddDllDirectory peut être utilisée pour ajouter n’importe quel chemin absolu à l’ensemble de répertoires qui sont 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 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 devez être installé sur la plateforme cible.

Spécifications