Função GopherGetAttributeA (wininet.h)

[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

Identificador para uma sessão gopher retornada por InternetConnect.

[in] lpszLocator

Ponteiro para uma cadeia de caracteres terminada em nulo que identifica o item no servidor Gopher no qual retornar informações de atributo.

[in] lpszAttributeName

Ponteiro para uma cadeia de caracteres delimitada por espaço que especifica 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 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 de atributo do Gopher serão colocadas no lpBuffer. Se lpfnEnumerator for especificado, 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 todos os dados do aplicativo.

Retornar valor

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

Comentários

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.

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.

Requisitos

Confira também

Funções WinINet