WINHTTP_CREDS_EX struttura (winhttp.h)

Articolo
08/27/2023

La struttura WINHTTP_CREDS_EX contiene informazioni sulle credenziali utente usate per l'autenticazione server e proxy.

Sintassi

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;

Members

lpszUserName

Puntatore a un buffer contenente il nome utente.

lpszPassword

Puntatore a un buffer contenente la password.

lpszRealm

Puntatore a un buffer che contiene l'area di autenticazione.

dwAuthScheme

Flag che contiene lo schema di autenticazione, come uno dei valori seguenti.

Valore	Significato
WINHTTP_AUTH_SCHEME_BASIC	Usare l'autenticazione di base.
WINHTTP_AUTH_SCHEME_NTLM	Usare l'autenticazione NTLM.
INHTTP_AUTH_SCHEME_DIGEST	Usare l'autenticazione del digest.
WINHTTP_AUTH_SCHEME_NEGOTIATE	Selezionare tra NTLM e l'autenticazione Kerberos.

lpszHostName

Puntatore a un buffer contenente il nome host.

dwPort

Porta di connessione del server.

lpszUrl

Puntatore a un buffer contenente l'URL di destinazione.

Commenti

Questa struttura viene usata con opzioni WINHTTP_OPTION_GLOBAL_SERVER_CREDS e flag di opzioneWINHTTP_OPTION_GLOBAL_PROXY_CREDS. Queste opzioni richiedono la chiave del Registro di sistema HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ShareCredsWithWinHttp. Questa chiave del Registro di sistema non è presente per impostazione predefinita.

Quando è impostato, WinINet invierà le credenziali a WinHTTP. Ogni volta che WinHttp ottiene una richiesta di autenticazione e se non sono presenti credenziali impostate sull'handle corrente, userà le credenziali fornite da WinINet. Per condividere le credenziali del server oltre alle credenziali proxy, gli utenti devono impostare il flag di opzione WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	winhttp.h

Vedi anche

WINHTTP_CREDS

Condividi tramite