CFtpConnection::CFtpConnection

2011-08-09

このメンバー関数は、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 に設定されます。