CGopherLocator クラス
gopher サーバーから gopher "locator" を取得し、ロケーターの種類を決定し、ロケーターを CGopherFileFind で使用できるようにします。
Note
クラス CGopherConnection、 CGopherFile、 CGopherFileFind、 CGopherLocator 、およびそのメンバーは、Windows XP プラットフォームでは動作しないため非推奨となりましたが、以前のプラットフォームでは引き続き動作します。
構文
class CGopherLocator : public CObject
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CGopherLocator::CGopherLocator | CGopherLocator オブジェクトを構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CGopherLocator::GetLocatorType | gopher ロケーターを解析し、その属性を決定します。 |
パブリック演算子
| 名前 | 説明 |
|---|---|
| CGopherLocator::operator LPCTSTR | C スタイルの文字列として CGopherLocator オブジェクトに格納されている文字に直接アクセスします。 |
解説
アプリケーションは、そのサーバーから情報を取得する前に、gopher サーバーのロケーターを取得する必要があります。 ロケーターを取得したら、ロケーターを不透明なトークンとして扱う必要があります。
各 gopher ロケーターには、検出されたファイルまたはサーバーの種類を決定する属性があります。 gopher ロケーターの種類の一覧については、「 GetLocatorType を参照してください。
アプリケーションは通常、 CGopherFileFind::FindFile の呼び出しにロケーターを使用して、特定の情報を取得します。
他の MFC インターネット クラスと連携 CGopherLocator 方法の詳細については、「WinInet を使用したInternet プログラミング 」の記事を参照してください。
継承階層
CGopherLocator
要件
Header: afxinet.h
CGopherLocator::CGopherLocator
このメンバー関数は、 CGopherLocator オブジェクトを作成するために呼び出されます。
CGopherLocator(const CGopherLocator& ref);
パラメーター
ref
定数 CGopherLocator オブジェクトへの参照。
解説
CGopherLocator オブジェクトを直接作成することはありません。 代わりに、 CGopherConnection::CreateLocator を呼び出して、 CGopherLocator オブジェクトへのポインターを作成して返します。
CGopherLocator::GetLocatorType
ロケーターの種類を取得するには、このメンバー関数を呼び出します。
BOOL GetLocatorType(DWORD& dwRef) const;
パラメーター
dwRef
ロケーターの種類を受け取る DWORD への参照。 ロケーターの種類のテーブルについては、「 Remarks 」を参照してください。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。 呼び出しが失敗した場合、Win32 関数 GetLastError を呼び出して、エラーの原因を特定できます。
解説
使用できる型は次のとおりです。
| 値 | 意味 |
|---|---|
| GOPHER_TYPE_TEXT_FILE | ASCII テキスト ファイル。 |
| GOPHER_TYPE_DIRECTORY | 追加の Gopher 項目のディレクトリ。 |
| GOPHER_TYPE_CSO | CSO 電話帳サーバー。 |
| GOPHER_TYPE_ERROR | エラー状態を示します。 |
| GOPHER_TYPE_MAC_BINHEX | BINEX 形式の Macintosh ファイル。 |
| GOPHER_TYPE_DOS_ARCHIVE | DOS アーカイブ ファイル。 |
| GOPHER_TYPE_UNIX_UUENCODED | UUENCODED ファイル。 |
| GOPHER_TYPE_INDEX_SERVER | インデックス サーバー。 |
| GOPHER_TYPE_TELNET | Telnet サーバー。 |
| GOPHER_TYPE_BINARY | バイナリ ファイル。 |
| GOPHER_TYPE_REDUNDANT | 複製されたサーバー。 この中に含まれる情報は、プライマリ サーバーの複製です。 プライマリ サーバーは、GOPHER_TYPE_REDUNDANTの種類を持たない最後のディレクトリ エントリです。 |
| GOPHER_TYPE_TN3270 | TN3270 サーバー。 |
| GOPHER_TYPE_GIF | GIF グラフィックス ファイル。 |
| GOPHER_TYPE_IMAGE | イメージ ファイル。 |
| GOPHER_TYPE_BITMAP | ビットマップ ファイル。 |
| GOPHER_TYPE_MOVIE | ムービー ファイル。 |
| GOPHER_TYPE_SOUND | サウンド ファイル。 |
| GOPHER_TYPE_HTML | HTML ドキュメント。 |
| GOPHER_TYPE_PDF | PDF ファイル。 |
| GOPHER_TYPE_CALENDAR | 予定表ファイル。 |
| GOPHER_TYPE_INLINE | インライン ファイル。 |
| GOPHER_TYPE_UNKNOWN | 項目の種類が不明です。 |
| GOPHER_TYPE_ASK | Ask+ 項目。 |
| GOPHER_TYPE_GOPHER_PLUS | Gopher+ 項目。 |
CGopherLocator::operator LPCTSTR
この便利なキャスト演算子は、 CGopherLocator オブジェクトに含まれる null で終わる C 文字列にアクセスするための効率的なメソッドを提供します。
operator LPCTSTR () const;
戻り値
文字列のデータへの文字ポインター。
解説
文字はコピーされません。ポインターだけが返されます。