CInternetSession::GetFtpConnection

[アーティクル]
08/09/2011

FTP 接続を確立し、CFtpConnection オブジェクトへのポインターを取得します。

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

パラメーター

pstrServer
FTP サーバー名を含んでいる文字列へのポインター。
pstrUserName
ログインするユーザー名を指定する NULL で終わる文字列へのポインター。 NULL の場合、既定値は anonymous です。

pstrPassword
ログインするユーザーのパスワードを指定する NULL で終わる文字列へのポインター pstrPassword と pstrUserName の両方が NULL の場合、既定の anonymous パスワードは、ユーザーの電子メールアドレスになります。 pstrPassword が NULL (または空の文字列) で、pstrUserName が NULL でない場合は、空白のパスワードが使用されます。 pstrUserName と pstrPassword の 4 とおりの設定と、それらの組み合わせを設定した結果を次の表に示します。

pstrUserName	pstrPassword	FTP サーバーに送信されるユーザー名	FTP サーバーに送信されるパスワード
NULL または " "	NULL または " "	"匿名"	ユーザーの電子メールアドレス
NULL ではない文字列	NULL または " "	pstrUserName	" "
NULL または NULL ではない文字列	ERROR	ERROR
NULL ではない文字列	NULL ではない文字列	pstrUserName	pstrPassword

nPort
サーバー上で使用する TCP/IP ポートを識別する番号。
bPassive
この FTP セッションのモードをパッシブまたはアクティブのいずれかで指定します。 TRUE に設定すると、Win32 API の dwFlag が INTERNET_FLAG_PASSIVE に設定されます。

戻り値

CFtpConnection オブジェクトへのポインターを返します。呼び出しに失敗した場合は、スローされた CInternetException オブジェクトを調べて、失敗の原因を特定してください。

解説

GetFtpConnection は、FTP サーバーに接続し、CFTPConnection オブジェクトへのポインターを作成して返します。サーバー上で特定の操作を実行することはありません。たとえば、ファイルを読み取ったり書き込んだりするには、これらの操作を別の手順として実行する必要があります。ファイルの検索、ファイルを開く操作、ファイルの読み取りと書き込みの詳細については、CFtpConnection クラスと CFtpFileFind クラスを参照してください。一般的な FTP 接続タスクを実行する手順については、「Win32 インターネット拡張機能 (WinInet)」を参照してください。