CInternetSession::GetFtpConnection

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich, aby ustanowić połączenie FTP i wskaźnik do CFtpConnection obiektu.

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

Parametry

pstrServer
Wskaźnik ciąg zawierający nazwę serwera FTP.
pstrUserName
Wskaźnik, aby ciąg zakończony znakiem null, który określa nazwę użytkownika, aby zalogować się.Jeśli NULL, domyślnie jest anonimowy.

pstrPassword
Wskaźnik ciąg zakończony znakiem null, który określa hasło używane do logowania.Jeśli oba pstrPassword i pstrUserName są NULL, domyślnego hasła anonimowego jest adres e-mail użytkownika.Jeśli pstrPassword jest NULL (lub pusty ciąg), ale pstrUserName nie jest NULL, używane jest hasło puste.W poniższej tabeli opisano zachowanie cztery możliwe ustawienia pstrUserName i pstrPassword:

pstrUserName	pstrPassword	Nazwa użytkownika są wysyłane do serwera FTP	Hasło wysłane do serwera FTP
NULL lub ""	NULL lub ""	"anonimowy"	Nazwy e-mail użytkownika
Non-NULL ciąg	NULL lub ""	pstrUserName	" "
NULL Non-NULL ciąg	BŁĄD	BŁĄD
Non-NULL ciąg	Non-NULL ciąg	pstrUserName	pstrPassword

nPort
Numer identyfikujący port TCP/IP na serwerze.
bPassive
Określa tryb pasywne i aktywne dla tej sesji FTP.Jeśli ustawiona na TRUE, ustawia Win32 API dwFlag do INTERNET_FLAG_PASSIVE.

Wartość zwracana

Wskaźnik do CFtpConnection obiektu.Jeżeli połączenie nie powiedzie się, należy określić przyczyny awarii, sprawdzając thrown CInternetException obiektu.

Uwagi

GetFtpConnectionłączy z serwerem FTP i tworzy i zwraca wskaźnik do CFTPConnection obiektu.Nie wykonuje żadnych operacji w serwerze.Jeśli zamierzasz odczytu lub zapisu do plików, na przykład wykonać tych działań jako osobnych kroków.Zobacz klasy CFtpConnection i CFtpFileFind informacji o wyszukiwaniu plików, otwierania plików i Odczyt lub zapis plików.Zobacz artykuł Internet Programming with WinInet dla czynności typowe zadania połączenia FTP.