Função GopherCreateLocatorA (wininet.h)

Artigo
11/20/2024

[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 um cadeia de caracteresterminada nula 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 do host. Se nServerPort for INTERNET_INVALID_PORT_NUMBER, a porta Gopher padrão será usada.

[in] lpszDisplayString

Ponteiro para um cadeia de caracteresterminada nula 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. Esse 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 de 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 de 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ário.

Valor de retorno

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

Observações

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.

Assim 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.

Observaçã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 do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

Funções WinINet

Compartilhar via