Função AddDllDirectory (libloaderapi.h)

  • Artigo

Adiciona um diretório ao caminho de pesquisa de DLL do processo.

Sintaxe

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Parâmetros

[in] NewDirectory

Um caminho absoluto para o diretório a ser adicionado ao caminho de pesquisa. Por exemplo, para adicionar o diretório Dir2 ao caminho de pesquisa da DLL do processo, especifique \Dir2. Para obter mais informações sobre caminhos, consulte Nomenclatura de arquivos, caminhos e namespaces.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro opaco que pode ser passado para RemoveDllDirectory para remover a DLL do caminho de pesquisa da DLL do processo.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função AddDllDirectory pode ser usada para adicionar qualquer caminho absoluto ao conjunto de diretórios pesquisados para uma DLL. Se SetDefaultDllDirectories for chamado pela primeira vez com LOAD_LIBRARY_SEARCH_USER_DIRS, os diretórios especificados com AddDllDirectory serão adicionados ao caminho de pesquisa da DLL do processo. Caso contrário, os diretórios especificados com a função AddDllDirectory são usados apenas para chamadas de função LoadLibraryEx que especificam LOAD_LIBRARY_SEARCH_USER_DIRS.

Se AddDllDirectory for usado para adicionar mais de um diretório ao caminho de pesquisa de DLL do processo, a ordem na qual esses diretórios são pesquisados não será especificada.

Para remover um diretório adicionado com AddDllDirectory, use a função RemoveDllDirectory .

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Para usar essa função em um aplicativo, chame GetProcAddress para recuperar o endereço da função de Kernel32.dll. KB2533623 deve ser instalado na plataforma de destino.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho], KB2533623 no Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho libloaderapi.h (inclua Windows.h)
DLL Kernel32.dll