Função AddDllDirectory (libloaderapi.h)

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 de DLL do processo, especifique \Dir2. Para obter mais informações sobre caminhos, consulte Arquivos de Nomenclatura, Caminhos e Namespaces.

Valor de retorno

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 de DLL do processo.

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

Observações

A função AddDllDirectory pode ser usada para adicionar qualquer caminho absoluto ao conjunto de diretórios que são 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 de 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.

Requirements