CInternetSession::GetGopherConnection

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

更新 : 2007 年 11 月

新しい gopher 接続を確立し、CGopherConnection オブジェクトへのポインタを取得します。

CGopherConnection* GetGopherConnection(
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER 
);

パラメータ

pstrServer
gopher サーバー名が含まれている文字列へのポインタ。
pstrUserName
ユーザー名が含まれている文字列へのポインタ。
pstrPassword
アクセスパスワードが含まれている文字列へのポインタ。
nPort
サーバー上で使用する TCP/IP ポートを識別する番号。

戻り値

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

解説

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