描述
设置要与HTTP服务器一起使用的凭据，无论是代理服务器还是始发服务器。
C / C ++语法
HRESULT SetCredentials( BSTR bstrUserName, BSTR bstrPassword, HTTPREQUEST_SETCREDENTIALS_FLAGS Flags ); |
PowerBASIC 语法
METHOD SetCredentials ( _ BYVAL bstrUserName AS WSTRING, _ BYVAL bstrPassword AS WSTRING, _ BYVAL Flags AS LONG _ ) |
参数
bstrUserName
[in]类型为BSTR的值，用于指定认证的用户名。
bstrPassword
[in]类型为BSTR的值，用于指定验证密码。如果bstrUserName为NULL或缺失，则忽略此参数。
Flags
[in]指定何时IWinHttpRequest使用凭据的值。可以是以下值之一：
值 |
含义 |
HTTPREQUEST_SETCREDENTIALS_FOR_SERVER |
证书被传递给服务器。 |
HTTPREQUEST_SETCREDENTIALS_FOR_PROXY |
证书被传递给代理。 |
返回值
此方法不返回值。
OBJRESULT
如果成功返回S_OK，否则返回错误值。
备注
如果对打开的调用尚未成功完成，则此方法返回错误值。假设在用户可以为会话设置凭据之前，必须发生与代理服务器或源服务器的某些度量的交互。此外，直到用户知道哪种身份验证方案得到支持，他们无法格式化凭据。
要与服务器和代理进行身份验证，应用程序必须调用SetCredentials两次;首先将Flags参数设置为HTTPREQUEST_SETCREDENTIALS_FOR_SERVER，其次，Flags参数设置为HTTPREQUEST_SETCREDENTIALS_FOR_PROXY。