DIF_TROUBLESHOOTER

Artikel
06/15/2023

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.