CGopherConnection::CreateLocator

Artigo
02/25/2013

Chamar essa função de membro para criar um localizador de Gopher para localizar ou identificar um arquivo em um servidor de 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 cadeia de caracteres que contém o nome do documento ou o diretório de Gopher a ser recuperados.Se o parâmetro de pstrDisplayString é NULO, o diretório padrão para o servidor de Gopher será retornado.
pstrSelectorString
Um ponteiro para a cadeia de caracteres de seletor seja enviada para o servidor de Gopher para recuperar um item.pstrSelectorString pode ser NULO.
dwGopherType
Isso especifica se pstrSelectorString se refere a um diretório ou um documento, e se a solicitação é Gopher ou gopher+.Consulte os atributos para a estrutura GOPHER_FIND_DATA em Windows SDK.
pstrLocator
Um ponteiro para uma cadeia de caracteres que identifica o arquivo para abrir o.Em geral, essa cadeia de caracteres é retornada de uma chamada a CGopherFileFind::GetLocator.
pstrServerName
Um ponteiro para uma cadeia de caracteres que contém o nome do servidor de Gopher.
nPort
O número que identifica a porta da Internet para a conexão.

Valor de retorno

Um objeto de CGopherLocator .

Comentários

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

Para recuperar informações de um servidor de Gopher, um aplicativo deve primeiro obter um localizador de Gopher.O aplicativo deve então manipular o localizador como um token opaco (isto é, o aplicativo pode usar o localizador mas não diretamente o manipular ou comparar).Normalmente, o aplicativo usa o localizador para chamadas para a função de membro de CGopherFileFind::FindFile para recuperar uma parte da informação específica.