CFtpConnection::CFtpConnection

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このメンバ関数は、CFtpConnection オブジェクトを構築するために呼び出されます。

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
);

パラメータ

pSession
関連する CInternetSession オブジェクトへのポインタ。
hConnected
現在のインターネットセッションの Windows ハンドル。
pstrServer
FTP サーバー名を含んでいる文字列へのポインタ。
dwContext
操作のコンテキスト ID。dwContext は、CInternetSession::OnStatusCallback で返される操作ステータス情報を識別します。既定では 1 が設定されます。しかし、操作に対して明示的に特定のコンテキスト ID を設定できます。オブジェクトとオブジェクトのすべての動作は、このコンテキスト ID に関連付けられます。
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 に設定されます。