Função GopherFindFirstFileW (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 GopherFindFirstFileW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszLocator,
[in] LPCWSTR lpszSearchString,
[out] LPGOPHER_FIND_DATAW lpFindData,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parâmetros
[in] hConnect
Manipule 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 uma recarga 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 qualquer dado do aplicativo.
Valor retornado
Retorna um identificador de pesquisa válido se for bem-sucedido 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 contendo 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 do 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 |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de