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
次のいずれかの値として、認証スキームを含むフラグ。
値 | 説明 |
---|---|
|
基本認証を使用します。 |
|
NTLM 認証を使用します。 |
|
ダイジェスト認証を使用します。 |
|
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 オプション フラグ を設定する必要があります。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
Header | winhttp.h |