DIF_TROUBLESHOOTER
Die DIF_TROUBLESHOOTER-Anforderung ermöglicht es einem Installationsprogramm, eine Problembehandlung für ein Gerät zu starten oder CHM- und HTM-Problembehandlungsdateien zurückzugeben, damit Windows gestartet werden kann.
Hinweis Dieser DIF-Code wird nur unter Windows Server 2003, Windows XP und Microsoft Windows 2000 unterstützt.
Sendebedingungen
Wenn ein Benutzer auf die Schaltfläche "Problembehandlung" für ein Gerät in Geräte-Manager klickt.
Wer verarbeitet
Klassen-Co-Installer |
Kann verarbeiten |
Geräte-Co-Installer |
Kann verarbeiten |
Klasseninstallationsprogramm |
Kann verarbeiten |
Installationsprogrammeingabe
DeviceInfoSet
Stellt dem Geräteinformationssatz , der das Gerät enthält, ein Handle bereit.
DeviceInfoData
Stellt einen Zeiger auf eine SP_DEVINFO_DATA-Struktur bereit, die das Gerät im Geräteinformationssatz identifiziert.
Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.
Klasseninstallationsparameter
DeviceInfoData ist eine SP_TROUBLESHOOTER_PARAMS Struktur zugeordnet.
Installationsprogrammausgabe
Klasseninstallationsparameter
Ein Installationsprogramm kann die SP_TROUBLESHOOTER_PARAMS ändern und eine CHM- oder HTML-Datei festlegen.
Installer-Rückgabewert
Wenn ein Co-Installer diese Anforderung nicht verarbeitet, gibt es NO_ERROR aus seinem Vorverarbeitungsdurchlauf zurück.
Wenn ein Co-Installer diese Anforderung verarbeitet, erfolgt dies im Nachverarbeitungsdurchlauf. Wenn das Co-Installationsprogramm CHM- und HTML-Dateien bereitstellt, werden die empfangenen status (wahrscheinlich ERROR_DI_DO_DEFAULT) weitergegeben. Wenn das Co-Installationsprogramm eine Problembehandlung ausführt und das Problem behebt, gibt der Co-Installer NO_ERROR zurück. Wenn das Co-Installationsprogramm eine Problembehandlung ausführt, das Problem aber nicht behebt, werden die empfangenen status (ERROR_DI_DO_DEFAULT) weitergegeben.
Wenn ein Klasseninstallationsprogramm eine CHM-Datei und eine HTML-Datei bereitstellt oder das Klasseninstallationsprogramm eine Problembehandlung ausführt, das Problem jedoch nicht behebt, gibt das Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT zurück. Windows ruft anschließend den Standardhandler auf.
Wenn ein Klasseninstallationsprogramm eine eigene Problembehandlung startet und das Problem behebt, gibt das Klasseninstallationsprogramm NO_ERROR zurück. Windows ruft den Standardhandler anschließend nicht auf.
Wenn beim Klasseninstallationsprogramm ein Fehler auftritt, gibt das Installationsprogramm einen entsprechenden Win32-Fehlercode zurück. Windows ruft den Standardhandler anschließend nicht auf.
Standard-DIF-Codehandler
Keine
Es gibt keinen Standardhandler für DIF_TROUBLESHOOTER, aber das Betriebssystem bietet Standardproblembehandlungen, die versuchen, Geräteprobleme zu beheben, wenn keine vom Installationsprogramm bereitgestellten Problembehandlungen vorhanden sind.
Installationsprogrammvorgang
Ein Installationsprogramm ruft CM_Get_DevNode_Status auf, um das Gerät status und den CM-Problemcode abzurufen. Je nach Problem kann ein Installationsprogramm eine Problembehandlung, eine Hilfedatei oder nichts bereitstellen. Eine Problembehandlung kann möglicherweise ein Problem mit einem Gerät beheben. Wenn das Problem durch eine Problembehandlung behoben wird, sollte SetupDiCallClassInstaller aufgerufen werden, um eine DIF_PROPERTYCHANGE Anforderung vom Typ DICS_PROPCHANGE zu senden. Wenn ein Installationsprogramm keine Problembehandlung für ein Gerät bereitstellt, kann es eine Hilfedatei mit Vorschlägen zur Problemlösung für den Benutzer bereitstellen.
Wenn kein Installer eine eigene Problembehandlung ausführt, führt Windows HTML-Hilfe aus, um dem Benutzer Informationen anzuzeigen. Wenn ein Installationsprogramm eine CHM-Datei in den Klasseninstallationsparametern bereitgestellt hat, zeigt Windows diese Datei an. Andernfalls zeigt Windows vom System bereitgestellte Problembehandlungsinformationen an.
Die Klasseninstallationsparameter enthalten höchstens ein ChmFile - und HtmlTroubleShooter-Paar . Wenn mehr als ein Installationsprogramm diese Werte angibt, verwendet Windows die Werte, die vom letzten Installationsprogramm festgelegt wurden, das die DIF-Anforderung verarbeitet hat.
Weitere Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes.
Requirements (Anforderungen)
Version |
Unterstützt in Windows Server 2003, Windows XP und Microsoft Windows 2000. |
Header |
Setupapi.h (einschließlich Setupapi.h) |