CGopherConnection::CreateLocator

發行項
06/10/2015

呼叫此成員函式建立 Gopher 定位器尋找或識別在 Gopher 伺服器的檔案。

CGopherLocator CreateLocator( 
   LPCTSTR pstrDisplayString, 
   LPCTSTR pstrSelectorString, 
   DWORD dwGopherType  
); 
static CGopherLocator CreateLocator( 
   LPCTSTR pstrLocator  
); 
static CGopherLocator CreateLocator( 
   LPCTSTR pstrServerName, 
   LPCTSTR pstrDisplayString, 
   LPCTSTR pstrSelectorString, 
   DWORD dwGopherType, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER  
);

參數

pstrDisplayString
out 包含至檔案或目錄的名稱字串的指標會擷取。如果 pstrDisplayString 參數為， NULLGopher 伺服器的預設目錄傳回。
pstrSelectorString
要傳送的選取器字串的指標 Gopher 伺服器以擷取項目。 pstrSelectorString 可以是 NULL。
dwGopherType
這會指定 pstrSelectorString 是否參考某個目錄或檔案，然後，要求是 Gopher 或 gopher+。在 Windows SDK的結構 GOPHER_FIND_DATA 請參閱屬性。
pstrLocator
out 識別檔案的字串的指標會開啟。通常，這個字串從一個對的呼叫傳回 CGopherFileFind::GetLocator。
pstrServerName
out 包含 Gopher 伺服器名稱之字串的指標。
nPort
識別這個連接的數字網際網路連接埠。

傳回值

CGopherLocator 物件。

備註

而非靜態版本使用連接物件的伺服器名稱，成員函式的靜態版本要求您指定伺服器。

若要從 Gopher 伺服器擷取資訊，應用程式必須先取得 Gopher 定位器。應用程式必須接著會視為定位器做為不透明語彙基元 (也就是應用程式可以使用定位器，但不會直接操作或比較)。通常，應用程式會呼叫使用定位器至 CGopherFileFind::FindFile 成員函式來擷取特定的資訊片段。