CGopherLocator クラス

  • [アーティクル]

gopher サーバーから gopher "locator" を取得し、ロケーターの種類を決定し、CGopherFileFind でロケーターを使用できるようにします。

Note

クラスCGopherConnection、CGopherFile、CGopherFileFindCGopherLocatorおよびそのメンバーは、Windows XP プラットフォームでは動作しないため非推奨になりましたが、以前のプラットフォームでは引き続き動作します。

構文

class CGopherLocator : public CObject

メンバー

パブリック コンストラクター

名前 説明
CGopherLocator::CGopherLocator CGopherLocator オブジェクトを構築します。

パブリック メソッド

名前 説明
CGopherLocator::GetLocatorType gopher ロケーターを解析し、その属性を決定します。

パブリック演算子

名前 説明
CGopherLocator::operator LPCTSTR C スタイルの文字列として CGopherLocator オブジェクトに格納されている文字に直接アクセスします。

解説

アプリケーションは、そのサーバーから情報を取得する前に、gopher サーバーのロケーターを取得する必要があります。 ロケーターを取得したら、ロケーターを不透明なトークンとして扱う必要があります。

各 gopher ロケーターには、検出されたファイルまたはサーバーの種類を決定する属性があります。 gopher ロケーターの種類の一覧については、「 GetLocatorType 」を参照してください。

通常、アプリケーションは CGopherFileFind::FindFile の呼び出しにロケーターを使用して、特定の情報を取得します。

他の MFC インターネット クラスでの動作の詳細については、WinInet を使用したインターネット プログラミングに関CGopherLocatorする記事を参照してください。

継承階層

CObject

CGopherLocator

必要条件

ヘッダー: afxinet.h

CGopherLocator::CGopherLocator

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

CGopherLocator(const CGopherLocator& ref);

パラメーター

ref
定数 CGopherLocator オブジェクトへの参照。

解説

オブジェクトを CGopherLocator 直接作成することはありません。 代わりに、CGopherConnection::CreateLocator を呼び出して、オブジェクトへのポインターを作成してCGopherLocator返します。

CGopherLocator::GetLocatorType

ロケーターの種類を取得するには、このメンバー関数を呼び出します。

BOOL GetLocatorType(DWORD& dwRef) const;

パラメーター

dwRef
ロケーターの種類を受け取る DWORD への参照。 ロケーターの種類の表については、「解説」を参照してください。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。 呼び出しが失敗した場合、Win32 関数 GetLastError を呼び出してエラーの原因を特定できます。

解説

使用できる型は次のとおりです。

Value 意味
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_Standard Edition RVER インデックス サーバー。
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

この便利なキャスト演算子は、オブジェクトに含まれる null で終わる C 文字列にアクセスするための効率的なメソッドを CGopherLocator 提供します。

operator LPCTSTR () const;

戻り値

文字列のデータへの文字ポインター。

解説

文字はコピーされません。ポインターだけが返されます。

関連項目

CObject クラス
階層図
CGopherFileFind クラス