Fonction SetDefaultDllDirectories (libloaderapi.h)
Spécifie un ensemble par défaut de répertoires à rechercher lorsque le processus appelant charge une DLL. Ce chemin de recherche est utilisé lorsque LoadLibraryEx est appelé sans indicateur LOAD_LIBRARY_SEARCH .
Syntaxe
BOOL SetDefaultDllDirectories(
[in] DWORD DirectoryFlags
);
Paramètres
[in] DirectoryFlags
Répertoires à rechercher. Ce paramètre peut être n’importe quelle combinaison des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Si cette valeur est utilisée, le répertoire d’installation de l’application fait l’objet d’une recherche. |
|
Cette valeur est une combinaison de LOAD_LIBRARY_SEARCH_APPLICATION_DIR, LOAD_LIBRARY_SEARCH_SYSTEM32 et LOAD_LIBRARY_SEARCH_USER_DIRS.
Cette valeur représente le nombre maximal recommandé de répertoires qu’une application doit inclure dans son chemin de recherche DLL. |
|
Si cette valeur est utilisée, %windows%\system32 est recherché. |
|
Si cette valeur est utilisée, tout chemin d’accès explicitement ajouté à l’aide de la fonction AddDllDirectory ou SetDllDirectory fait l’objet d’une recherche. Si plusieurs répertoires ont été ajoutés, l’ordre dans lequel ces répertoires sont recherchés n’est pas spécifié. |
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Le chemin de recherche dll est l’ensemble de répertoires recherchés pour une DLL lorsqu’un chemin d’accès complet n’est pas spécifié dans un appel de fonction LoadLibrary ou LoadLibraryEx , ou lorsqu’un chemin d’accès complet à la DLL est spécifié, mais que le système doit rechercher des DLL dépendantes. Pour plus d’informations sur le chemin de recherche de DLL standard, consultez Dynamic-Link Library Search Order.
Le chemin de recherche DLL standard contient des répertoires qui peuvent être vulnérables à une attaque de préchargement dll. Une application peut utiliser la fonction SetDefaultDllDirectories pour spécifier un chemin de recherche DLL par défaut pour le processus qui élimine les répertoires les plus vulnérables et limite les autres répertoires recherchés. Le chemin de recherche de la DLL de processus s’applique uniquement au processus appelant et persiste pendant toute la durée du processus.
Si le paramètre DirectoryFlags spécifie plusieurs indicateurs, les répertoires sont recherchés dans l’ordre suivant :
- Répertoire qui contient la DLL (LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR). Ce répertoire est recherché uniquement pour les dépendances de la DLL en cours de chargement.
- Répertoire de l’application (LOAD_LIBRARY_SEARCH_APPLICATION_DIR).
- Chemins d’accès explicitement ajoutés au chemin de recherche de l’application avec la fonction AddDllDirectory (LOAD_LIBRARY_SEARCH_USER_DIRS) ou la fonction SetDllDirectory . Si plusieurs chemins ont été ajoutés, l’ordre dans lequel les chemins d’accès sont recherchés n’est pas spécifié.
- Répertoire système (LOAD_LIBRARY_SEARCH_SYSTEM32).
Il n’est pas possible de revenir au chemin de recherche DE DLL standard ou de supprimer un répertoire spécifié avec SetDefaultDllDirectories du chemin de recherche. Toutefois, le chemin de recherche dll du processus peut être remplacé en appelant LoadLibraryEx avec un ou plusieurs indicateurs de LOAD_LIBRARY_SEARCH , et les répertoires ajoutés avec AddDllDirectory peuvent être supprimés en appelant RemoveDllDirectory.
Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Pour appeler cette fonction dans une application, utilisez la fonction GetProcAddress pour récupérer son adresse à partir de Kernel32.dll. KB2533623 doivent être installés sur la plateforme cible.
Spécifications
| 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 |
Voir aussi
Ordre de recherche de bibliothèque de liens dynamiques