Función AddDllDirectory (libloaderapi.h)

  • Artículo

Agrega un directorio a la ruta de búsqueda del archivo DLL del proceso.

Sintaxis

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Parámetros

[in] NewDirectory

Ruta de acceso absoluta al directorio que se va a agregar a la ruta de acceso de búsqueda. Por ejemplo, para agregar el directorio Dir2 a la ruta de búsqueda dll del proceso, especifique \Dir2. Para obtener más información sobre las rutas de acceso, vea Asignar nombres a archivos, rutas de acceso y espacios de nombres.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero opaco que se puede pasar a RemoveDllDirectory para quitar el archivo DLL de la ruta de búsqueda del archivo DLL del proceso.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función AddDllDirectory se puede usar para agregar cualquier ruta de acceso absoluta al conjunto de directorios que se buscan en un archivo DLL. Si primero se llama a SetDefaultDllDirectories con LOAD_LIBRARY_SEARCH_USER_DIRS, los directorios especificados con AddDllDirectory se agregan a la ruta de búsqueda del archivo DLL del proceso. De lo contrario, los directorios especificados con la función AddDllDirectory solo se usan para las llamadas de función LoadLibraryEx que especifican LOAD_LIBRARY_SEARCH_USER_DIRS.

Si AddDllDirectory se usa para agregar más de un directorio a la ruta de búsqueda dll del proceso, no se especifica el orden en el que se buscan esos directorios.

Para quitar un directorio agregado con AddDllDirectory, use la función RemoveDllDirectory .

Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: Para usar esta función en una aplicación, llame a GetProcAddress para recuperar la dirección de la función de Kernel32.dll. KB2533623 debe instalarse en la plataforma de destino.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio],KB2533623 en Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado libloaderapi.h (incluya Windows.h)
Archivo DLL Kernel32.dll