CInternetSession::GetGopherConnection

[アーティクル]
08/09/2011

新しい 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)」を参照してください。