GetDllDirectoryA-Funktion (winbase.h)

Ruft den anwendungsspezifischen Teil des Suchpfads ab, der zum Suchen nach DLLs für die Anwendung verwendet wird.

Syntax

DWORD GetDllDirectoryA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Parameter

[in] nBufferLength

Die Größe des Ausgabepuffers in Zeichen.

[out] lpBuffer

Ein Zeiger auf einen Puffer, der den anwendungsspezifischen Teil des Suchpfads empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, entspricht der Rückgabewert der Länge der in lpBuffer kopierten Zeichenfolge in Zeichen ohne das abschließende NULL-Zeichen. Wenn der Rückgabewert größer als nBufferLength ist, gibt er die Größe des puffers an, der für den Pfad erforderlich ist.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0502 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Hinweis

Der winbase.h-Header definiert GetDllDirectory als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Dynamic Link Library-Suchreihenfolge

SetDllDirectory