Share via

estrutura WINHTTP_CREDS (winhttp.h)

  • Artigo

A estrutura WINHTTP_CREDS contém informações de credencial de usuário usadas para autenticação de servidor e proxy.

Nota Essa estrutura foi preterida. Em vez disso, o uso da estrutura WINHTTP_CREDS_EX é recomendado.
 

Sintaxe

typedef struct tagWINHTTP_CREDS {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
} WINHTTP_CREDS, *PWINHTTP_CREDS;

Membros

lpszUserName

Ponteiro para um buffer que contém o nome de usuário.

lpszPassword

Ponteiro para um buffer que contém senha.

lpszRealm

Ponteiro para um buffer que contém realm.

dwAuthScheme

Um sinalizador que contém o esquema de autenticação, como um dos valores a seguir.

Valor Significado
WINHTTP_AUTH_SCHEME_BASIC
 Use a autenticação básica.
WINHTTP_AUTH_SCHEME_NTLM
 Use a autenticação NTLM.
INHTTP_AUTH_SCHEME_DIGEST
 Use a autenticação digest.
WINHTTP_AUTH_SCHEME_NEGOTIATE
 Selecione entre a autenticação NTLM e Kerberos.

lpszHostName

Ponteiro para um buffer que contém o nome do host.

dwPort

A porta de conexão do servidor.

Comentários

Essa estrutura é usada com opções WINHTTP_OPTION_GLOBAL_SERVER_CREDS e sinalizadores de opção WINHTTP_OPTION_GLOBAL_PROXY_CREDS. Essas opções exigem a chave do Registro HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Essa chave do Registro não está presente por padrão.

Quando estiver definido, o WinINet enviará credenciais para o WinHTTP. Sempre que o WinHttp receber um desafio de autenticação e se não houver credenciais definidas no identificador atual, ele usará as credenciais fornecidas pelo WinINet. Para compartilhar credenciais do servidor além das credenciais de proxy, os usuários precisam definir o sinalizador de opção WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winhttp.h

Confira também

WINHTTP_CREDS_EX