分享方式:


CGopherLocator 類別

從 gopher 伺服器取得 gopher「定位器」、判斷定位器的型別,並讓定位器可供 CGopherFileFind 使用

注意

類別 CGopherConnectionCGopherFileCGopherFileFindCGopherLocator 和 其成員已被取代,因為它們無法在 Windows XP 平台上運作,但他們會繼續在舊版平台上運作。

語法

class CGopherLocator : public CObject

成員

公用建構函式

名稱 描述
CGopherLocator::CGopherLocator 建構 CGopherLocator 物件。

公用方法

名稱 描述
CGopherLocator::GetLocatorType 剖析 Gopher 定位器並判斷其屬性。

公用運算子

名稱 描述
CGopherLocator::operator LPCTSTR 直接存取儲存在物件中的 CGopherLocator 字元做為 C 樣式字串。

備註

應用程式必須先取得 Gopher 伺服器的定位器,才能從該伺服器擷取資訊。 一旦定位器具有定位器,它就必須將定位器視為不透明的令牌。

每個 Gopher 定位器都有屬性,可決定找到的檔案或伺服器類型。 如需 Gopher 定位器類型的清單,請參閱 GetLocatorType

應用程式通常會使用定位器來 呼叫 CGopherFileFind::FindFile 來擷取特定資訊片段。

若要深入瞭解如何使用CGopherLocator其他 MFC 因特網類別,請參閱使用 WinInet 進行因特網程式設計一文

繼承階層架構

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。 如果呼叫失敗,可能會呼叫 Win32 函式 GetLastError 來判斷錯誤的原因。

備註

可能的型別如下:

意義
GOPHER_TYPE_TEXT_FILE ASCII 文字檔。
GOPHER_TYPE_DIRECTORY 其他 Gopher 項目的目錄。
GOPHER_TYPE_CSO CSO 電話簿伺服器。
GOPHER_TYPE_ERROR 表示錯誤狀況。
GOPHER_TYPE_MAC_BINHEX BINHEX 格式的 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;

傳回值

字串數據的字元指標。

備註

不會複製任何字元;只會傳回指標。

另請參閱

CObject 類別
階層架構圖表
CGopherFileFind 類別