CInternetSession::GetFtpConnection

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um eine FTP-Verbindung abzurufen und einen Zeiger auf einen CFtpConnection-Objekt zu erstellen.

CFtpConnection* GetFtpConnection(
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   BOOL bPassive = FALSE 
);

Parameter

pstrServer
Ein Zeiger auf eine Zeichenfolge, die den FTP-Server-Namen enthält.
pstrUserName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Benutzers angibt, sich anzumelden.Wenn NULL, Standard anonym ist.

pstrPassword
Ein Zeiger auf eine auf NULL endende Zeichenfolge, die das Kennwort angibt, um zu verwenden, um anzumelden.Wenn pstrPassword und pstrUserNameNULL sind, ist das standardmäßige anonyme Kennwort der E-Mail-Name des Benutzers.Wenn pstrPasswordNULL (oder eine leere Zeichenfolge) ist, aber pstrUserName ist nicht NULL, wird ein leeres Kennwort verwendet.Die folgende Tabelle beschreibt das Verhalten für die vier möglichen Einstellungen von pstrUserName und von pstrPassword:

pstrUserName	pstrPassword	Benutzername an den FTP-Server	Kennwort an den FTP-Server
NULL "oder "	NULL "oder "	"anonym"	E-Mail-Name des Benutzers
Nicht NULL Zeichenfolge	NULL "oder "	pstrUserName	""
Nicht NULL Zeichenfolge NULL	BUG	BUG
Nicht NULL Zeichenfolge	Nicht NULL Zeichenfolge	pstrUserName	pstrPassword

nPort
Eine Zahl, die den TCP/IP-Anschluss identifiziert, um auf dem Server zu verwenden.
bPassive
Gibt den passiven oder aktiven Modus für diese FTP-Sitzung an.Wenn dies auf TRUE, es die Win32-API dwFlag zu INTERNET_FLAG_PASSIVE festgelegt wird.

Rückgabewert

Ein Zeiger auf ein CFtpConnection-Objekt.Wenn der Aufruf fehlschlägt, ermitteln Sie die Ursache des Fehlers, indem Sie das ausgelöste CInternetException-Objekt überprüfen.

Hinweise

GetFtpConnection verbindet einen FTP-Server her und erstellt und gibt einen Zeiger auf einen CFTPConnection-Objekt zurück.Es wird kein Einzelgeschäft auf dem Server aus.Wenn Sie beabsichtigen zu lesen, oder in Dateien schreiben beispielsweise müssen Sie diese Vorgänge als separate Schritte ausführen.Siehe die Klassen CFtpConnection und CFtpFileFind zu Informationen zum Suchen nach Dateien, das Öffnen von Dateien und zum Lesen oder Schreiben von Dateien.Weitere Informationen finden Sie im Artikel Webprogrammierung mit WinInet-Klassen für Schritte, wenn Sie allgemeine FTP-Verbindungsaufgaben ausführen.