CGopherLocator 類別
從 gopher 伺服器取得 gopher「定位器」、判斷定位器的型別,並讓定位器可供 CGopherFileFind 使用。
注意
類別 CGopherConnection
、CGopherFile
、 CGopherFileFind
CGopherLocator
和 其成員已被取代,因為它們無法在 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 進行因特網程式設計一文。
繼承階層架構
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;
傳回值
字串數據的字元指標。
備註
不會複製任何字元;只會傳回指標。