Implementieren von Finish-Install Aktionen
Hinweis
In diesem Abschnitt beschriebene Features werden in universellen oder mobilen Treiberpaketen nicht unterstützt. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei.
Installationsprogramme (ein Klasseninstaller, Klassen-Co-Installer oder Geräte-Co-Installer) stellen Aktionen zur Endinstallation bereit. Eine Fertigstellen-Installation-Aktion kann ein ausführbares Programm ausführen, einen Prozess erstellen, einen Thread erstellen oder Code im Installationsabschluss-Prozess des Gerätetreibers ausführen.
Zum Implementieren von Aktionen zum Abschließen der Installation:
Legt das DI_FLAGSEX_FINISHINSTALL_ACTION-Flag fest, wenn das Installationsprogramm einen DIF_NEWDEVICEWIZARD_FINISHINSTALL DIF-Code verarbeitet und einen der folgenden Fehlercodes zurückgibt:
- ERROR_DI_DO_DEFAULT, wenn es sich um ein Klasseninstallationsprogramm ohne Seiten des Assistenten für die Fertiginstallation handelt.
- NO_ERROR, wenn es sich um ein Klasseninstallationsprogramm mit Seiten des Assistenten zum Abschließen der Installation oder um einen Co-Installer mit oder ohne Assistentenseiten für die fertige Installation handelt.
Führt die Aktionen zum Abschließen der Installation aus, wenn eine DIF_FINISHINSTALL_ACTION-Anforderung verarbeitet wird.
Ein Installationsprogramm gibt einen der Fehlercodes in der folgenden Tabelle zurück.
Fehlercode Bedeutung ERROR_DI_DO_DEFAULT
Klasseninstallationsprogramm: Der Klasseninstallationsinstaller hat seine Aktionen zum Abschließen der Installation erfolgreich ausgeführt und fordert Windows auf, die Standardverarbeitung durchzuführen. Ein Klasseninstallationsprogramm sollte diesen Fehlercode auch zurückgeben, wenn es keine Abschlussinstallationsaktionen aufweist.
Geräte- oder Klassen-Co-Installer: Co-Installer geben diesen Fehlercode nicht zurück.
NO_ERROR
Klasseninstallationsprogramm: Das Klasseninstallationsprogramm hat seine Aktion "Fertigstellen installieren" erfolgreich ausgeführt. Windows sollte die Standardverarbeitung nicht ausführen.
Geräte- oder Klassen-Co-Installer: Das Co-Installationsprogramm hat entweder erfolgreich seine Aktionen zum Abschließen der Installation ausgeführt oder verfügt über keine Aktionen zum Abschließen der Installation.
Microsoft Win32-Fehler
Beim Installationsprogramm ist ein Fehler aufgetreten, aber die Aktion "Fertigstellen der Installation" sollte erneut versucht werden. Wenn Sie einen Win32-Fehlercode zurückgeben, wird angegeben, dass Windows beim nächsten Aufzählen des Geräts einen weiteren Abschlussinstallationsvorgang ausführen sollte, um die Aktionen zum Abschließen der Installation abzuschließen.
Hinweis Wenn eine Abschlussinstallationsaktion fehlschlägt und nicht erneut versucht werden soll, gibt ein Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT und ein Geräte- oder Klassen-Co-Installer NO_ERROR zurück.
Informationen zum Entwickeln von Aktionen für die Endinstallation finden Sie unter Richtlinien für die Implementierung von Finish-Install Aktionen . Beispielcode, der zeigt, wie Sie Aktionen für die Abschlussinstallation implementieren, finden Sie in den folgenden Themen:
Codebeispiel: Finish-Install Actions in einem Klasseninstallationsprogramm