WINHTTP_CREDS_EX-Struktur (winhttp.h)

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

Syntax

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;

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 den 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 den Hostnamen enthält.

dwPort

Der Serververbindungsport.

lpszUrl

Zeiger auf einen Puffer, der die Ziel-URL enthält.

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\ShareCredsWithWinHttp erforderlich. 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

   
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