Funzione AddDllDirectory (libloaderapi.h)

Aggiunge una directory al percorso di ricerca della DLL del processo.

Sintassi

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Parametri

[in] NewDirectory

Percorso assoluto della directory da aggiungere al percorso di ricerca. Ad esempio, per aggiungere la directory Dir2 al percorso di ricerca dll del processo, specificare \Dir2. Per altre informazioni sui percorsi, vedere Denominazione di file, percorsi e spazi dei nomi.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore opaco che può essere passato a RemoveDllDirectory per rimuovere la DLL dal percorso di ricerca dll del processo.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

La funzione AddDllDirectory può essere usata per aggiungere qualsiasi percorso assoluto al set di directory in cui viene eseguita la ricerca di una DLL. Se SetDefaultDllDirectories viene chiamato per la prima volta con LOAD_LIBRARY_SEARCH_USER_DIRS, le directory specificate con AddDllDirectory vengono aggiunte al percorso di ricerca dll del processo. In caso contrario, le directory specificate con la funzione AddDllDirectory vengono usate solo per le chiamate di funzione LoadLibraryEx che specificano LOAD_LIBRARY_SEARCH_USER_DIRS.

Se AddDllDirectory viene usato per aggiungere più directory al percorso di ricerca della DLL del processo, l'ordine in cui vengono cercate tali directory non è specificato.

Per rimuovere una directory aggiunta con AddDllDirectory, usare la funzione RemoveDllDirectory .

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Per usare questa funzione in un'applicazione, chiamare GetProcAddress per recuperare l'indirizzo della funzione da Kernel32.dll. KB2533623 deve essere installato nella piattaforma di destinazione.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8 [solo app desktop],KB2533623 in Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Header	libloaderapi.h (include Windows.h)
Library	kernel32. Movimento di liberazione
DLL	Kernel32.dll