CFtpConnection::CFtpConnection

Artikel
06/10/2015

Diese Memberfunktion wird aufgerufen, um ein CFtpConnection-Objekt zu erstellen.

CFtpConnection( 
   CInternetSession* pSession, 
   HINTERNET hConnected, 
   LPCTSTR pstrServer, 
   DWORD_PTR dwContext 
); 
CFtpConnection( 
   CInternetSession* pSession, 
   LPCTSTR pstrServer, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL, 
   DWORD_PTR dwContext = 0, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   BOOL bPassive = FALSE 
);

Parameter

pSession
Ein Zeiger auf den zugehörigen CInternetSession-Objekt.
hConnected
Das Windows-Handles der aktuellen Internet-Sitzung.
pstrServer
Ein Zeiger auf eine Zeichenfolge, die den FTP-Server-Namen enthält.
dwContext
Der Kontextbezeichner für den Vorgang. dwContext identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden. Der Standard ist auf 1 festgelegt; Sie können jedoch eine bestimmte Kontext-ID für den Vorgang explizit zuweisen. Das Objekt und alle Aufgaben, die es ausgegeben, werden mit dieser Kontext ID zugeordnet
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.

Hinweise

Sie erstellen ein Objekt CFtpConnection nie direkt. Stattdessen CInternetSession::GetFtpConnection Aufruf, der das CFptConnection-Objekt erstellt.