Share via

estrutura WINHTTP_CREDS_EX (winhttp.h)

  • Artigo

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

Sintaxe

typedef struct tagWINHTTP_CREDS_EX {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
  LPSTR lpszUrl;
} WINHTTP_CREDS_EX, *PWINHTTP_CREDS_EX;

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 de resumo.
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.

lpszUrl

Ponteiro para um buffer que contém a URL de destino.

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 de servidor além das credenciais de proxy, os usuários precisam definir o sinalizador de opção WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS.

Requisitos

   
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