Função GopherGetAttributeA (wininet.h)

Artigo
11/20/2024

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

Recupera as informações de atributo específicas do servidor.

Sintaxe

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [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 identifica o item no servidor Gopher no qual as informações de atributo devem ser retornadas.

[in] lpszAttributeName

Ponteiro para uma cadeia de caracteres delimitada por espaço especificando os nomes dos atributos a serem retornados. Se lpszAttributeName for NULL, GopherGetAttribute retornará informações sobre todos os atributos.

[out] lpBuffer

Ponteiro para um buffer definido pelo aplicativo do qual as informações de atributo são recuperadas.

[in] dwBufferLength

Tamanho do buffer de lpBuffer , em TCHARs.

[out] lpdwCharactersReturned

Ponteiro para uma variável que contém o número de caracteres lidos no buffer lpBuffer.

[in] lpfnEnumerator

Ponteiro para uma função de retorno de chamada GopherAttributeEnumerator que enumera cada atributo do localizador. Esse parâmetro é opcional. Se for NULL, todas as informações do atributo Gopher serão colocadas em lpBuffer. Se lpfnEnumerator for especificada, a função de retorno de chamada será chamada uma vez para cada atributo do objeto.

A função de retorno de chamada recebe o endereço de uma única estrutura GOPHER_ATTRIBUTE_TYPE com cada chamada. A função de retorno de chamada de enumeração permite que o aplicativo evite ter que analisar as informações do atributo Gopher.

[in] dwContext

Valor definido pelo aplicativo que associa essa operação a qualquer dado do aplicativo.

Valor de retorno

Retorna VERDADEIRO se a solicitação for atendida ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError ou InternetGetLastResponseInfo.

Observações

Geralmente, os aplicativos chamam essa função depois de chamar GopherFindFirstFile ou InternetFindNextFile.

O tamanho do parâmetro lpBuffer deve ser igual ou maior que o valor de MIN_GOPHER_ATTRIBUTE_LENGTH.

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

do WinINet Functions

Compartilhar via