WINHTTP_CREDS-Struktur (winhttp.h)
Die WINHTTP_CREDS-Struktur enthält Benutzeranmeldeinformationen, die für die Server- und Proxyauthentifizierung verwendet werden.
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.
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 |