WINHTTP_CREDS_EX 結構 (winHTTP.h)

  • 發行項

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

語法

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_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