CGopherConnection::CreateLocator

Artigo
08/25/2010

telefonar Essa função de membro para criar um localizador gopher para localizar ou identificar um arquivo em um servidor 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 
);

Parâmetros

pstrDisplayString
Um ponteiro para uma seqüência de caracteres contendo o nome do gopher documento ou pasta a serem recuperados.Se o pstrDisplayString o parâmetro é NULO, o diretório padrão para o servidor gopher será retornado.
pstrSelectorString
Um ponteiro para a seqüência de caracteres do seletor para ser enviada ao servidor gopher para recuperar um item.pstrSelectorString pode ser NULO.
dwGopherType
Especifica se pstrSelectorString refere-se a um diretório ou o documento, e se a solicitação é gopher ou gopher +. Consulte os atributos para a estrutura GOPHER_FIND_DATA in the Windows SDK.
pstrLocator
Um ponteiro para uma seqüência de caracteres que identifica o arquivo a ser em aberto.Em geral, essa seqüência de caracteres é retornada de uma telefonar para CGopherFileFind::GetLocator.
pstrServerName
Um ponteiro para uma seqüência de caracteres que contém o nome do servidor gopher.
nPort
O número que identifica a porta de Internet para esta conexão.

Valor de retorno

A CGopherLocator objeto.

Comentários

A versão estática da função de membro requer que você especificar um servidor, enquanto a versão não-estático usa o nome do servidor do objeto de conexão.

Para recuperar informações de um servidor gopher, um aplicativo deve primeiro obter um localizador gopher.O aplicativo deve tratar o localizador, em seguida, sistema autônomo um token de opaco (ou seja, o aplicativo pode usar o localizador, mas não diretamente manipular ou compará-la).Normalmente, o aplicativo usa o localizador para chamadas para o CGopherFileFind::FindFilefunção de membro para recuperar uma informação específica.