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
Zeigen Sie auf eine mit Null beendete 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 Platz für ein endendes NULL-Zeichen enthalten. Die Verwendung einer Länge von MAX_PATH reicht für alle Pfade aus. Wenn die Funktion zurückgegeben wird, empfängt die Variable die Anzahl der zeichen, die in den Puffer kopiert wurden.
Rückgabewert
Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastError-auf, um eine bestimmte Fehlermeldung zu erhalten.
Bemerkungen
Wenn der lpszCurrentDirectory Puffer nicht groß genug ist, erhält lpdwCurrentDirectory die Anzahl der Bytes, die zum Abrufen des vollständigen, aktuellen Verzeichnisnamens erforderlich sind.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.
Anmerkung
Der wininet.h-Header definiert FtpGetCurrentDirectory 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | wininet.h |
| Library | Wininet.lib |
| DLL- | Wininet.dll |