GetDllDirectoryA-Funktion (winbase.h)
Ruft den anwendungsspezifischen Teil des Suchpfads ab, der zum Suchen von 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, ist der Rückgabewert die Länge der Zeichenfolge, die in lpBuffer-kopiert wurde, in Zeichen, nicht einschließlich des endenden NULL-Zeichens.If the function succeeds, the return value is the length of the string copied to lpBuffer, in characters, not including the endating null character. Wenn der Rückgabewert größer als nBufferLengthist, gibt er die Größe des für den Pfad erforderlichen Puffers an.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
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.
Anmerkung
Der winbase.h-Header definiert GetDllDirectory als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista, Windows XP mit SP1 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |