structure WINHTTP_CREDS_EX (winhttp.h)

Article
03/15/2023

La structure WINHTTP_CREDS_EX contient des informations d’identification utilisateur utilisées pour l’authentification du serveur et du proxy.

Syntaxe

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;

Membres

lpszUserName

Pointeur vers une mémoire tampon qui contient le nom d’utilisateur.

lpszPassword

Pointeur vers une mémoire tampon qui contient un mot de passe.

lpszRealm

Pointeur vers une mémoire tampon qui contient le domaine.

dwAuthScheme

Indicateur qui contient le schéma d’authentification, comme l’une des valeurs suivantes.

Valeur	Signification
WINHTTP_AUTH_SCHEME_BASIC	Utilisez l’authentification de base.
WINHTTP_AUTH_SCHEME_NTLM	Utilisez l’authentification NTLM.
INHTTP_AUTH_SCHEME_DIGEST	Utilisez l’authentification digest.
WINHTTP_AUTH_SCHEME_NEGOTIATE	Sélectionnez entre NTLM et l’authentification Kerberos.

lpszHostName

Pointeur vers une mémoire tampon qui contient le nom d’hôte.

dwPort

Port de connexion du serveur.

lpszUrl

Pointeur vers une mémoire tampon qui contient l’URL cible.

Remarques

Cette structure est utilisée avec les options WINHTTP_OPTION_GLOBAL_SERVER_CREDS et les indicateurs d’options WINHTTP_OPTION_GLOBAL_PROXY_CREDS. Ces options nécessitent la clé de Registre HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ShareCredsWithWinHttp. Cette clé de Registre n’est pas présente par défaut.

Lorsqu’il est défini, WinINet envoie les informations d’identification à WinHTTP. Chaque fois que WinHttp reçoit un défi d’authentification et s’il n’y a pas d’informations d’identification définies sur le handle actuel, il utilise les informations d’identification fournies par WinINet. Pour partager les informations d’identification du serveur en plus des informations d’identification du proxy, les utilisateurs doivent définir l’indicateur d’option WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winhttp.h

Voir aussi

WINHTTP_CREDS

Share via