FtpGetCurrentDirectoryA-Funktion (wininet.h)

  • Artikel

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 WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst aus verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).
 

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

Weitere Informationen

FTP-Sitzungen

FtpSetCurrentDirectory

WinINet-Funktionen