struttura WINHTTP_CREDS (winhttp.h)

Articolo
03/13/2024

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

Nota Questa struttura è stata deprecata. È invece consigliabile usare la struttura WINHTTP_CREDS_EX .

Sintassi

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

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 digest.
WINHTTP_AUTH_SCHEME_NEGOTIATE	Selezionare tra l'autenticazione NTLM e Kerberos.

lpszHostName

Puntatore a un buffer contenente il nome host.

dwPort

Porta di connessione del server.

Commenti

Questa struttura viene usata con le opzioni WINHTTP_OPTION_GLOBAL_SERVER_CREDS e i 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 riceve una richiesta di autenticazione e se non sono presenti credenziali impostate nell'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

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

Vedi anche

WINHTTP_CREDS_EX

Condividi tramite