estrutura WINHTTP_CREDS_EX (winhttp.h)

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.

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

Confira também

WINHTTP_CREDS