FtpGetCurrentDirectoryA-Funktion (wininet.h)
Ruft das aktuelle Verzeichnis für die angegebene FTP-Sitzung ab.
Syntax
BOOL FtpGetCurrentDirectoryA(
[in] HINTERNET hConnect,
[out] LPSTR lpszCurrentDirectory,
[in, out] LPDWORD lpdwCurrentDirectory
);
Parameter
[in] hConnect
Behandeln sie eine FTP-Sitzung.
[out] lpszCurrentDirectory
Zeiger auf eine NULL-Zeichenfolge, die den absoluten Pfad des aktuellen Verzeichnisses empfängt.
[in, out] lpdwCurrentDirectory
Zeiger auf eine Variable, die die Länge des Puffers in TCHARs angibt. Die Pufferlänge muss Raum für ein beendendes NULL-Zeichen enthalten. Die Verwendung einer Länge von MAX_PATH ist für alle Pfade ausreichend. Wenn die Funktion zurückgibt, empfängt die Variable die Anzahl der Zeichen, die in den Puffer kopiert wurden.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Rufen Sie GetLastError auf, um eine bestimmte Fehlermeldung zu erhalten.
Hinweise
Wenn der Puffer lpszCurrentDirectory nicht groß genug ist, empfängt lpdwCurrentDirectory die Anzahl von Bytes, die zum Abrufen des vollständigen aktuellen Verzeichnisnamens erforderlich sind.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
Der wininet.h-Header definiert FtpGetCurrentDirectory 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 nicht codierungsneutralem Code 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 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wininet.h |
| Bibliothek | Wininet.lib |
| DLL | Wininet.dll |