CGopherConnection::CreateLocator

Chiamare la funzione membro per creare un indicatore di posizione di gopher per trovare o identificare un file in un server 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 
);

Parametri

  • pstrDisplayString
    Un puntatore a una stringa contenente il nome del documento o della directory di gopher da recuperare.Se il parametro pstrDisplayString è NULL, la directory predefinita per il server gopher viene restituita.

  • pstrSelectorString
    Un puntatore alla stringa del selettore al server gopher per recuperare un elemento.pstrSelectorString può essere NULL.

  • dwGopherType
    Indica se pstrSelectorString fa riferimento a una directory o un documento e se la richiesta è gopher o gopher+.Vedere gli attributi della struttura GOPHER_FIND_DATA in Windows SDK.

  • pstrLocator
    Un puntatore a una stringa che identifica il file da aprire.In genere, questa stringa viene restituita da una chiamata a CGopherFileFind::GetLocator.

  • pstrServerName
    Un puntatore a una stringa contenente il nome del server gopher.

  • nPort
    Il numero che identifica la porta Internet per questa connessione.

Valore restituito

Un oggetto CGopherLocator.

Note

La versione della funzione membro è necessario specificare un server, mentre la versione di non statico utilizza il nome del server dall'oggetto connessione.

Per recuperare informazioni da un server gopher, un'applicazione deve innanzitutto ottenere un localizzatore di gopher.L'applicazione deve quindi considerare il localizzatore come token opaco ovvero l'applicazione può utilizzare il localizzatore ma non tramite modifica diretta o confrontare).In genere, l'applicazione utilizza il localizzatore per le chiamate alla funzione membro CGopherFileFind::FindFile per recuperare un'informazione specifica.

Requisiti

Header: afxinet.h

Vedere anche

Riferimenti

Classe di CGopherConnection

Grafico della gerarchia

Classe di CFtpConnection

Classe di CHttpConnection

Classe di CInternetConnection

Classe di CGopherLocator

Classe di CGopherFileFind