Função GopherCreateLocatorA (wininet.h)

[A função GopherCreateLocator está disponível para uso nos sistemas operacionais especificados na seção Requisitos.]

Cria uma cadeia de caracteres de localizador Gopher ou Gopher+ das partes de componente da cadeia de caracteres do seletor.

Sintaxe

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

Parâmetros

[in] lpszHost

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do host ou um endereço IP decimal pontilhado (como 198.105.232.1).

[in] nServerPort

Número da porta no qual o servidor Gopher em lpszHost reside, em ordem de byte de host. Se nServerPort for INTERNET_INVALID_PORT_NUMBER, a porta gopher padrão será usada.

[in] lpszDisplayString

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o documento ou diretório Gopher a ser exibido. Se esse parâmetro for NULL, a função retornará o diretório padrão para o servidor Gopher.

[in] lpszSelectorString

Ponteiro para a cadeia de caracteres do seletor a ser enviada para o servidor Gopher para recuperar informações. Este parâmetro pode ser NULL.

[in] dwGopherType

Determina se lpszSelectorString se refere a um diretório ou documento e se a solicitação é Gopher+ ou Gopher. O valor padrão, GOPHER_TYPE_DIRECTORY, será usado se o valor de dwGopherType for zero. Esse pode ser um dos valores de tipo gopher.

[out] lpszLocator

Ponteiro para um buffer que recebe a cadeia de caracteres do localizador. Se lpszLocator for NULL, lpdwBufferLength receberá o comprimento do buffer necessário, mas a função não executará nenhum outro processamento.

[in, out] lpdwBufferLength

Ponteiro para uma variável que contém o comprimento do buffer lpszLocator , em caracteres. Quando a função retorna, esse parâmetro recebe o número de caracteres gravados no buffer. Se GetLastError retornar ERROR_INSUFFICIENT_BUFFER, esse parâmetro receberá o número de caracteres necessários.

Valor retornado

Retorna TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError ou InternetGetLastResponseInfo.

Comentários

Para recuperar informações de um servidor Gopher, um aplicativo deve primeiro obter um "localizador" gopher do servidor Gopher.

O localizador, que o aplicativo deve tratar como um token opaco, normalmente é usado para chamadas para a função GopherFindFirstFile para recuperar uma informação específica.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

 

Observação

O cabeçalho wininet.h define GopherCreateLocator como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wininet.h
Biblioteca	Wininet.lib
DLL	Wininet.dll

Confira também

Funções WinINet