WINHTTP_CREDS_EX结构 (winhttp.h)

WINHTTP_CREDS_EX 结构包含用于服务器和代理身份验证的用户凭据信息。

语法

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;

成员

lpszUserName

指向包含用户名的缓冲区的指针。

lpszPassword

指向包含密码的缓冲区的指针。

lpszRealm

指向包含领域的缓冲区的指针。

dwAuthScheme

包含身份验证方案的标志,作为以下值之一。

含义
WINHTTP_AUTH_SCHEME_BASIC
使用基本身份验证。
WINHTTP_AUTH_SCHEME_NTLM
使用 NTLM 身份验证。
INHTTP_AUTH_SCHEME_DIGEST
使用摘要式身份验证。
WINHTTP_AUTH_SCHEME_NEGOTIATE
在 NTLM 和 Kerberos 身份验证之间进行选择。

lpszHostName

指向包含主机名的缓冲区的指针。

dwPort

服务器连接端口。

lpszUrl

指向包含目标 URL 的缓冲区的指针。

注解

此结构与选项 WINHTTP_OPTION_GLOBAL_SERVER_CREDSWINHTTP_OPTION_GLOBAL_PROXY_CREDS选项标志一起使用。 这些选项需要注册表项 HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ShareCredsWithWinHttp。 默认情况下,此注册表项不存在。

设置后,WinINet 会将凭据向下发送到 WinHTTP。 每当 WinHttp 收到身份验证质询时,如果当前句柄上未设置凭据,它将使用 WinINet 提供的凭据。 为了共享除代理凭据之外的服务器凭据,用户需要设置 WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS 选项标志。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 winhttp.h

另请参阅

WINHTTP_CREDS