Função GopherFindFirstFileA (wininet.h)

Artigo
11/20/2024

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

Usa um localizador gopher e critérios de pesquisa para criar uma sessão com o servidor e localizar os documentos solicitados, arquivos binários, servidores de índice ou árvores de diretório.

Sintaxe

HINTERNET GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA lpFindData,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Parâmetros

[in] hConnect

Manipule para uma sessão do Gopher retornada por InternetConnect.

[in] lpszLocator

Ponteiro para um cadeia de caracteresterminada nula que contém o nome do item a ser localizado. Este pode ser um dos seguintes:

Localizador gopher retornado por uma chamada anterior para essa função ou a função InternetFindNextFile.
ponteiro nulo ou cadeia de caracteres vazia indicando que as informações mais altas de um servidor Gopher estão sendo retornadas.
Localizador criado pela função GopherCreateLocator.

[in] lpszSearchString

Ponteiro para um buffer que contém as cadeias de caracteres a serem pesquisada, se essa solicitação for para um servidor de índice. Caso contrário, esse parâmetro deve ser NULL.

[out] lpFindData

Ponteiro para uma estrutura de GOPHER_FIND_DATA que recebe as informações recuperadas por essa função.

[in] dwFlags

Controla o comportamento da função. Esse parâmetro pode ser uma combinação dos valores a seguir.

Valor	Significado
INTERNET_FLAG_HYPERLINK	Força um recarregamento se não houver tempo expirado e nenhum tempo LastModified retornado do servidor ao determinar se o item deve ser recarregado da rede.
INTERNET_FLAG_NEED_FILE	Faz com que um arquivo temporário seja criado se o arquivo não puder ser armazenado em cache.
INTERNET_FLAG_NO_CACHE_WRITE	Não adiciona a entidade retornada ao cache.
INTERNET_FLAG_RELOAD	Força um download da listagem de arquivo, objeto ou diretório solicitado do servidor de origem, não do cache.
INTERNET_FLAG_RESYNCHRONIZE	Recarrega recursos HTTP se o recurso tiver sido modificado desde a última vez em que foi baixado. Todos os recursos FTP e Gopher são recarregados.

[in] dwContext

Ponteiro para uma variável que contém o valor definido pelo aplicativo que associa essa pesquisa a qualquer dado do aplicativo.

Valor de retorno

Retorna um identificador de pesquisa válido se bem-sucedido ou NULL caso contrário. Para recuperar informações de erro estendidas, chame GetLastError ou InternetGetLastResponseInfo.

Observações

GopherFindFirstFile se assemelha muito à função FindFirstFile. Ele cria uma conexão com um servidor Gopher e retorna uma única estrutura que contém informações sobre o primeiro objeto Gopher referenciado pela cadeia de caracteres do localizador.

Depois de chamar GopherFindFirstFile para recuperar o primeiro objeto Gopher em uma enumeração, um aplicativo pode usar a função InternetFindNextFile para recuperar objetos Gopher subsequentes.

Depois que o aplicativo de chamada terminar de usar o identificador HINTERNET retornado por GopherFindFirstFile, ele deverá ser fechado usando a função InternetCloseHandle.

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 GopherFindFirstFile 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

do WinINet Functions

Compartilhar via