CGopherConnection::CGopherConnection

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

更新 : 2007 年 11 月

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

CGopherConnection(
   CInternetSession* pSession,
   HINTERNET hConnected,
   LPCTSTR pstrServer,
   DWORD_PTR dwContext
);
CGopherConnection(
   CInternetSession* pSession,
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   DWORD_PTR dwContext = 0,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER
);

パラメータ

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