WINHTTP_CREDS_EX structure (winhttp.h)

The WINHTTP_CREDS_EX structure contains user credential information used for server and proxy authentication.

Syntax

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;

Members

lpszUserName

Pointer to a buffer that contains username.

lpszPassword

Pointer to a buffer that contains password.

lpszRealm

Pointer to a buffer that contains realm.

dwAuthScheme

A flag that contains the authentication scheme, as one of the following values.

lpszHostName

Pointer to a buffer that contains hostname.

dwPort

The server connection port.

lpszUrl

Pointer to a buffer that contains target URL.

Remarks

This structure is used with options WINHTTP_OPTION_GLOBAL_SERVER_CREDS and WINHTTP_OPTION_GLOBAL_PROXY_CREDS option flags. These options require the registry key HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ShareCredsWithWinHttp. This registry key is not present by default.

When it is set, WinINet will send credentials down to WinHTTP. Whenever WinHttp gets an authentication challenge and if there are no credentials set on the current handle, it will use the credentials provided by WinINet. In order to share server credentials in addition to proxy credentials, users needs to set the WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS option flag.

Requirements

See also

WINHTTP_CREDS