WINHTTP_CREDS_EX (Vista)

描述

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

C / C ++语法

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;

PowerBASIC 语法

TYPE WINHTTP_CREDS_EX

lpszUserName AS ASCIIZ PTR

lpszPassword AS ASCIIZ PTR

lpszRealm AS ASCIIZ PTR

dwAuthScheme AS DWORD

lpszHostName AS ASCIIZ PTR

dwPort AS DWORD

lpszUrl AS ASCIIZ PTR

END TYPE

成员

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_CREDS和WINHTTP_OPTION_GLOBAL_PROXY_CREDS选项标志一起使用。这些选项需要注册表项HKLM \\ Software \\ Microsoft \\ Windows \\ CurrentVersion \\ Internet Settings！ShareCredsWithWinHttp.默认情况下，此注册表项不存在。设置完成后，WinINet会将凭据下载到WinHTTP。每当WinHttp获得身份验证挑战，并且如果当前句柄上没有设置凭据，它将使用WinINet提供的凭据。为了共享服务器凭据以及代理凭据，用户需要设置WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS选项标志。