Partager via


structure WINHTTP_CREDS_EX (winhttp.h)

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