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.

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

Weitere Informationen

WINHTTP_CREDS