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