Funzione AddDllDirectory (libloaderapi.h)

  • Articolo

Aggiunge una directory al percorso di ricerca 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione AddDllDirectory può essere usata per aggiungere qualsiasi percorso assoluto al set di directory che vengono ricercate per una DLL. Se SetDefaultDllDirectories viene chiamato prima 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 dll del processo, l'ordine in cui tali directory vengono ricercate 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 Valore
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
Intestazione libloaderapi.h (includere Windows.h)
DLL Kernel32.dll