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 |