Freigeben über


CGopherConnection::CreateLocator

Rufen Sie die Memberfunktion auf, um einen Gopher-Locator erstellen, um eine Datei auf einem Gopherserver zu suchen oder zu identifizieren.

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  
);

Parameter

  • pstrDisplayString
    Ein Zeiger auf eine Zeichenfolge, die den Namen des abgerufen werden Gopher-Dokuments oder -Verzeichnisses enthält. Wenn der pstrDisplayString-Parameter NULL ist, wird das Standardverzeichnis für den Gopherserver zurückgegeben.

  • pstrSelectorString
    Ein Zeiger auf die, um ein Element abzurufen zum Gopherserver gesendet werden, Wählzeichenfolge. pstrSelectorString kann NULL sein.

  • dwGopherType
    Gibt an, ob pstrSelectorString ein Verzeichnis oder ein Dokument verweist und ob die Anforderung Gopher oder gopher+ ist. Siehe die Attribute für die Struktur GOPHER_FIND_DATA in Windows SDK.

  • pstrLocator
    Ein Zeiger auf eine Zeichenfolge, die die Datei angibt, um zu öffnen. Im Allgemeinen wird diese Zeichenfolge in einem Aufruf CGopherFileFind::GetLocator zurückgegeben.

  • pstrServerName
    Ein Zeiger auf eine Zeichenfolge, die den Gopherservernamen enthält.

  • nPort
    Die Zahl, die den Internet-Anschluss für diese Verbindung identifiziert.

Rückgabewert

Ein CGopherLocator-Objekt.

Hinweise

Die statische Version der Memberfunktion erfordert, dass Sie einen Server an, während die nicht statische Version den Servernamen aus dem Verbindungsobjekt verwendet.

Um Informationen von einem Gopherserver abzurufen, muss eine Anwendung einen Gopher-Locator zuerst abrufen. Die Anwendung muss den Locator als nicht transparenten Token dann behandeln (das heißt, kann die Anwendung den Locator verwenden jedoch nicht direkt diesen bearbeiten oder vergleichen). Normalerweise verwendet die Anwendung - Locator für Aufrufe der CGopherFileFind::FindFile-Memberfunktion, um eine bestimmte Informationen abzurufen.

Anforderungen

Header: afxinet.h

Siehe auch

Referenz

CGopherConnection-Klasse

Hierarchiediagramm

CFtpConnection-Klasse

CHttpConnection-Klasse

CInternetConnection-Klasse

CGopherLocator-Klasse

CGopherFileFind-Klasse