CInternetSession::GetFtpConnection

Článek
06/10/2015

Volání funkce této členské připojení FTP a získat ukazatel CFtpConnection objektu.

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

Parametry

pstrServer
Ukazatel na řetězec obsahující název serveru FTP.
pstrUserName
Ukazatel na řetězec zakončený hodnotou null určující jméno uživatele přihlásit.Pokud NULL, výchozí nastavení je anonymní.

pstrPassword
Ukazatel na řetězec zakončený hodnotou null, který určuje heslo pro přihlášení.Pokud oba pstrPassword a pstrUserName jsou NULL, je výchozí heslo anonymního uživatele e-mailu.Pokud pstrPassword je NULL (nebo prázdný řetězec), ale pstrUserName není NULL, je použít prázdné heslo.Následující tabulka popisuje chování pro čtyři možné nastavení pstrUserName a pstrPassword :

pstrUserName	pstrPassword	Uživatelské jméno odeslány na FTP server	Heslo odesláno na FTP server
NULL nebo ""	NULL nebo ""	"anonymní"	Uživatelské jméno e-mailu
Non-NULL řetězec	NULL nebo ""	pstrUserName	" "
NULL Non-NULL řetězec	CHYBA	CHYBA
Non-NULL řetězec	Non-NULL řetězec	pstrUserName	pstrPassword

nPort
Číslo identifikující port TCP/IP na serveru.
bPassive
Určuje režim pasivní nebo aktivní relaci FTP.Pokud nastavena na TRUE, nastaví rozhraní Win32 API dwFlag na INTERNET_FLAG_PASSIVE.

Vrácená hodnota

Ukazatel CFtpConnection objektu.Pokud selže volání, zjistit příčinu chyby na základě thrown CInternetException objektu.

Poznámky

GetFtpConnectionpřipojení k serveru FTP a vytvoří a vrací ukazatel CFTPConnection objektu.Neprovádí žádné zvláštní operace na serveru.Pokud chcete číst nebo zapisovat soubory, například je nutné provést tyto operace jako samostatné kroky.Viz třídy CFtpConnection a CFtpFileFind informace o vyhledávání souborů, soubory, otevření a čtení nebo zápisu do souborů.Naleznete v článku Internet programování s WinInet kroky při provádění běžných úloh připojení FTP.