Função GopherOpenFileA (wininet.h)

Artigo
11/20/2024

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

Começa a ler um arquivo de dados gopher de um servidor Gopher.

Sintaxe

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [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 especifica o arquivo a ser aberto. Geralmente, esse localizador é retornado de uma chamada para GopherFindFirstFile ou InternetFindNextFile. Como o protocolo Gopher não tem nenhum conceito de diretório atual, o localizador é sempre totalmente qualificado.

[in] lpszView

Ponteiro para um cadeia de caracteresterminada nula que descreve a exibição a ser aberta se existirem várias exibições do arquivo no servidor. Se lpszView estiver NULL, a função usará a exibição de arquivo padrão.

[in] dwFlags

Condições sob as quais ocorrem transferências subsequentes. Esse parâmetro pode ser qualquer um 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 um valor definido pelo aplicativo que associa essa operação a qualquer dado do aplicativo.

Valor de retorno

Retornará um identificador se tiver êxito ou NULL se o arquivo não puder ser aberto. Para recuperar informações de erro estendidas, chame GetLastError ou InternetGetLastResponseInfo.

Observações

GopherOpenFile abre um arquivo em um servidor Gopher. Como um arquivo não pode realmente ser aberto ou bloqueado em um servidor, essa função simplesmente associa informações de localização a um identificador que um aplicativo pode usar para operações baseadas em arquivo, como InternetReadFile ou GopherGetAttribute.

Depois que o aplicativo de chamada terminar de usar o identificador HINTERNET retornado por GopherOpenFile, 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 GopherOpenFile 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. 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