Função GopherFindFirstFileA (wininet.h)

  • Artigo

[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

Identificador para uma sessão gopher retornada por InternetConnect.

[in] lpszLocator

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do item a ser localizado. Pode ser um dos seguintes:

  • Localizador gopher retornado por uma chamada anterior para essa função ou a função InternetFindNextFile .
  • Ponteiro NULL 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 deverá ser NULL.

[out] lpFindData

Ponteiro para uma estrutura 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 seguintes valores.

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 do arquivo, objeto ou listagem de 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 todos os dados do aplicativo.

Valor retornado

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

Comentários

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 .

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