CGopherConnection::CGopherConnection

2011-08-09

このメンバー関数は、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