Função GopherFindFirstFileA (wininet.h)
[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 |
|---|---|
|
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. |
|
Faz com que um arquivo temporário seja criado se o arquivo não puder ser armazenado em cache. |
|
Não adiciona a entidade retornada ao cache. |
|
Força um download do arquivo, objeto ou listagem de diretório solicitado do servidor de origem, não do cache. |
|
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.
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 |