WINHTTP_CREDS structure (winhttp.h)

Article
03/04/2024

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

Note Cette structure a été déconseillée. Au lieu de cela, l’utilisation de la structure WINHTTP_CREDS_EX est recommandée.

Syntaxe

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

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 l’authentification NTLM et l’authentification Kerberos.

lpszHostName

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

dwPort

Port de connexion au serveur.

Remarques

Cette structure est utilisée avec les options WINHTTP_OPTION_GLOBAL_SERVER_CREDS et WINHTTP_OPTION_GLOBAL_PROXY_CREDSindicateurs d’option. 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 obtient une demande d’authentification et si aucune information d’identification n’est définie 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

Condition requise	Valeur
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_EX

Partager via