共用方式為

winHTTP.h) (WINHTTP_CREDS 結構

  • 發行項

WINHTTP_CREDS結構包含用於伺服器和 Proxy 驗證的使用者認證資訊。

注意 此結構已被取代。 相反地，建議使用 WINHTTP_CREDS_EX 結構。
 

語法

typedef struct tagWINHTTP_CREDS {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
} WINHTTP_CREDS, *PWINHTTP_CREDS;

成員

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

伺服器連接埠。

備註

此結構會與選項 WINHTTP_OPTION_GLOBAL_SERVER_CREDS 和 WINHTTP_OPTION_GLOBAL_PROXY_CREDS選項旗標搭配使用。 這些選項需要登錄機碼 HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings！ShareCredsWithWinHttp。 此登錄機碼預設不存在。

設定時，WinINet 會將認證向下傳送至 WinHTTP。 每當 WinHttp 取得驗證挑戰，而且目前句柄上沒有設定認證時，就會使用 WinINet 所提供的認證。 除了 Proxy 認證之外，若要共用伺服器認證，用戶必須設定 WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS 選項旗標。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 winhttp.h

另請參閱

WINHTTP_CREDS_EX