InternetErrorDlg-Funktion (wininet.h)
Zeigt ein Dialogfeld für den Fehler an, der an InternetErrorDlg übergeben wird, sofern ein entsprechendes Dialogfeld vorhanden ist. Wenn das flag FLAGS_ERROR_UI_FILTER_FOR_ERRORS verwendet wird, überprüft die Funktion auch die Header auf ausgeblendete Fehler und zeigt bei Bedarf ein Dialogfeld an.
Syntax
DWORD InternetErrorDlg(
[in] HWND hWnd,
[in, out] HINTERNET hRequest,
[in] DWORD dwError,
[in] DWORD dwFlags,
[in, out] LPVOID *lppvData
);
Parameter
[in] hWnd
Handle zum übergeordneten Fenster für alle erforderlichen Dialogfelder. Wenn kein Dialogfeld erforderlich ist und FLAGS_ERROR_UI_FLAGS_NO_UI an dwFlags übergeben wird, kann dieser Parameter NULL sein.
[in, out] hRequest
Handle für die Internetverbindung, die beim Aufruf von HttpSendRequest verwendet wird.
[in] dwError
Fehlerwert, für den ein Dialogfeld angezeigt werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
|
Ermöglicht dem Benutzer, die Umleitung zu bestätigen. |
|
Zeigt ein Dialogfeld an, das angibt, dass das automatische Proxyskript ungültig ist. |
|
Zeigt ein Dialogfeld an, in dem der Benutzer gefragt wird, ob die angegebenen Daten in einem nicht sicheren Kanal bereitgestellt werden sollen. |
|
Der Server fordert ein Clientzertifikat an.
Der Rückgabewert für diesen Fehler ist immer ERROR_SUCCESS, unabhängig davon, ob der Benutzer ein Zertifikat ausgewählt hat. Wenn der Benutzer kein Zertifikat ausgewählt hat, wird bei der nachfolgenden Anforderung die anonyme Clientauthentifizierung versucht. |
|
Benachrichtigt den Benutzer über die Zonenüberquerung an einen sicheren Standort. |
|
Benachrichtigt den Benutzer über die Zonenüberquerung von einem sicheren Standort aus. |
|
Benachrichtigt den Benutzer, dass die bereitgestellten Daten jetzt an eine nicht sichere Website umgeleitet werden. |
|
Zeigt ein Dialogfeld an, in dem der Name und das Kennwort des Benutzers angefordert werden. |
|
Gibt an, dass der allgemeine Name des SSL-Zertifikats (Hostnamenfeld) falsch ist. Zeigt ein Dialogfeld Ungültiger allgemeiner SSL-Name an, und der Benutzer kann das falsche Zertifikat anzeigen. |
|
Zeigt dem Benutzer eine Warnung zu gemischten sicheren und nicht sicheren Inhalten an. |
|
Zeigt ein Dialogfeld an, in dem der Benutzer gefragt wird, ob die angegebenen Daten in einem nicht sicheren Kanal bereitgestellt werden sollen. |
|
Gibt an, dass der allgemeine Name des SSL-Zertifikats (Hostnamenfeld) falsch ist. Zeigt ein Dialogfeld Ungültiger allgemeiner SSL-Name an, und der Benutzer kann das falsche Zertifikat anzeigen. Ermöglicht dem Benutzer auch die Auswahl eines Zertifikats als Reaktion auf eine Serveranforderung. |
|
Zeigt dem Benutzer eine Warnung an, die die Probleme mit dem Serverzertifikat anzeigt. |
|
Teilt dem Benutzer mit, dass das SSL-Zertifikat abgelaufen ist. |
|
Zeigt dem Benutzer eine Warnung an, die zeigt, dass die Sperrprüfung des Serverzertifikats fehlgeschlagen ist. |
|
Zeigt ein Dialogfeld an, das angibt, dass das Serverzertifikat widerrufen wurde. |
|
Zeigt ein Dialogfeld an, das angibt, dass das Skript für den automatischen Proxy nicht heruntergeladen werden konnte. |
[in] dwFlags
Aktionen Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.
| Wert | Bedeutung |
|---|---|
|
Überprüft die zurückgegebenen Header auf Fehler. Rufen Sie InternetErrorDlg auf, wobei dieses Flag nach einem Aufruf von HttpSendRequest festgelegt ist, um ausgeblendete Fehler zu erkennen. Authentifizierungsfehler werden z. B. normalerweise ausgeblendet, weil der Aufruf von HttpSendRequest erfolgreich abgeschlossen wird. Durch das Überprüfen der status Codes kann InternetErrorDlg jedoch feststellen, dass der Proxy oder Server eine Authentifizierung erfordert. |
|
Wenn die Funktion erfolgreich ist, werden die Ergebnisse des Dialogfelds im Internethandle gespeichert. |
|
Fragt das Internethandle nach erforderlichen Informationen ab. Die -Funktion erstellt die entsprechende Datenstruktur für den Fehler. (Bei Zertifikat-CN-Fehlern greift die Funktion beispielsweise auf das Zertifikat.) |
|
Serialisiert Authentifizierungsdialogfelder für gleichzeitige Anforderungen für einen Kennwortcacheeintrag. Der lppvData-Parameter sollte die Adresse eines Zeigers auf eine INTERNET_AUTH_NOTIFY_DATA-Struktur enthalten, und der Client sollte eine threadsichere, nicht blockierende Rückruffunktion implementieren. |
|
Ermöglicht dem Aufrufer, NULL ohne Fehler an den hWnd-Parameter zu übergeben. Wird in Situationen verwendet, in denen keine Benutzeroberfläche erforderlich ist. |
[in, out] lppvData
Zeiger auf die Adresse einer Datenstruktur. Die Struktur kann für jeden Fehler, der behandelt werden muss, unterschiedlich sein.
Rückgabewert
Gibt einen der folgenden Werte oder andernfalls einen Fehlerwert zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen.
Weitere Informationen finden Sie unter ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED im dwError-Parameter . |
|
Die Funktion wurde vom Benutzer abgebrochen. |
|
Dies gibt an, dass die Funktion ihre Anforderung wiederholen muss. Bei der Authentifizierung bedeutet dies, dass der Benutzer auf die Schaltfläche OK geklickt hat. |
|
Das Handle für das übergeordnete Fenster ist ungültig. |
Hinweise
Informieren Sie den Benutzer immer, wenn eines der folgenden Ereignisse eintritt:
- ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR
- ERROR_INTERNET_INVALID_CA
- ERROR_INTERNET_POST_IS_NON_SECURE
- ERROR_INTERNET_SEC_CERT_CN_INVALID
- ERROR_INTERNET_SEC_CERT_DATE_INVALID
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wininet.h |
| Bibliothek | Wininet.lib |
| DLL | Wininet.dll |