Função GopherCreateLocatorW (wininet.h)

  • Artigo

[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+ com base nas partes de componente da cadeia de caracteres do seletor.

Sintaxe

BOOL GopherCreateLocatorW(
  [in]      LPCWSTR       lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCWSTR       lpszDisplayString,
  [in]      LPCWSTR       lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPWSTR        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 reside o servidor Gopher em lpszHost , na ordem de bytes do 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.

Retornar valor

Retornará 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 de 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 de servidor ou serviços, 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

Requisito Valor
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