WINHTTP_CREDS-Struktur (winhttp.h)

Artikel
08/27/2023

Die WINHTTP_CREDS-Struktur enthält Benutzeranmeldeinformationen, die für die Server- und Proxyauthentifizierung verwendet werden.

Hinweis Diese Struktur ist veraltet. Stattdessen wird die Verwendung der WINHTTP_CREDS_EX-Struktur empfohlen.

Syntax

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

Member

lpszUserName

Zeiger auf einen Puffer, der den Benutzernamen enthält.

lpszPassword

Zeiger auf einen Puffer, der ein Kennwort enthält.

lpszRealm

Zeiger auf einen Puffer, der bereich enthält.

dwAuthScheme

Ein Flag, das das Authentifizierungsschema als einen der folgenden Werte enthält.

Wert	Bedeutung
WINHTTP_AUTH_SCHEME_BASIC	Verwenden Sie die Standardauthentifizierung.
WINHTTP_AUTH_SCHEME_NTLM	Verwenden Sie die NTLM-Authentifizierung.
INHTTP_AUTH_SCHEME_DIGEST	Verwenden Sie die Digestauthentifizierung.
WINHTTP_AUTH_SCHEME_NEGOTIATE	Wählen Sie zwischen NTLM- und Kerberos-Authentifizierung aus.

lpszHostName

Zeiger auf einen Puffer, der hostnamen enthält.

dwPort

Der Serververbindungsport.

Hinweise

Diese Struktur wird mit Optionen WINHTTP_OPTION_GLOBAL_SERVER_CREDS und WINHTTP_OPTION_GLOBAL_PROXY_CREDSOptionsflags verwendet. Für diese Optionen ist der Registrierungsschlüssel HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings erforderlich! ShareCredsWithWinHttp. Dieser Registrierungsschlüssel ist standardmäßig nicht vorhanden.

Wenn sie festgelegt ist, sendet WinINet Anmeldeinformationen an WinHTTP. Wenn WinHttp eine Authentifizierungsanforderung erhält und keine Anmeldeinformationen für das aktuelle Handle festgelegt sind, werden die von WinINet bereitgestellten Anmeldeinformationen verwendet. Um neben Proxyanmeldeinformationen auch Serveranmeldeinformationen freizugeben, müssen Benutzer das WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS-Optionsflag festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winhttp.h

Weitere Informationen

WINHTTP_CREDS_EX

Freigeben über