DIF_FINISHINSTALL_ACTION
Eine DIF_FINISHINSTALL_ACTION-Anforderung ermöglicht es einem Installationsprogramm, Nach Abschluss der Installation Aktionen in einem interaktiven Administratorkontext auszuführen, nachdem alle anderen Geräteinstallationsvorgänge abgeschlossen sind.
Sendebedingungen
In Windows 8 und höheren Versionen werden Fertigstelleninstallationsaktionen nicht automatisch als Teil der Geräteinstallation ausgeführt. Zum Abschließen einer Geräteinstallationsaktion muss ein Benutzer im Info-Center auf "Installation der Gerätesoftware fertig stellen" klicken, um die Installation abzuschließen.
Weitere Informationen finden Sie unter Ausführen Finish-Install Aktionen.
In Windows 7 wird der Abschlussinstallationsvorgang nur im Kontext eines Benutzers mit Administratoranmeldeinformationen zu einem der folgenden Zeiten ausgeführt:
- Das nächste Mal, wenn sich ein Benutzer mit Administratoranmeldeinformationen anmeldet, während das Gerät angefügt ist.
- Wenn das Gerät erneut angefügt wird.
- Wenn der Benutzer Auf Hardwareänderungen in Geräte-Manager überprüfen auswählt.
Wenn ein Benutzer ohne Administratorrechte angemeldet ist, fordert Windows den Benutzer zur Eingabe der Zustimmung und der Anmeldeinformationen auf, um die Aktionen zum Abschließen der Installation in einem Administratorkontext auszuführen.
Wer verarbeitet
Klassen-Co-Installer |
Kann verarbeiten |
Geräte-Co-Installer |
Kann verarbeiten |
Klasseninstallationsprogramm |
Kann verarbeiten |
Installationsprogrammeingabe
DeviceInfoSet
Ein Handle für den Geräteinformationssatz , der das zu installierende Gerät enthält.
DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das zu installierende Gerät darstellt.
Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (eine SP_DEVINSTALL_PARAMS-Struktur) zugeordnet.
Klasseninstallationsparameter
Keine
Installationsprogrammausgabe
Geräteinstallationsparameter
Ein Installationsprogramm legt das DI_NEEDREBOOT-Flag fest, wenn ein Systemneustart erforderlich ist, um die Aktionen zur Endinstallation abzuschließen.
Installer-Rückgabewert
Ein Installationsprogramm gibt einen der Werte zurück, die in der folgenden Tabelle aufgeführt sind.
| Rückgabewert | Bedeutung |
|---|---|
ERROR_DI_DO_DEFAULT |
Klasseninstallationsprogramm: Das Installationsprogramm verfügt über keine Abschlussinstallationsaktionen, hat die Aktionen zum Abschließen der Installation erfolgreich abgeschlossen oder hat festgestellt, dass es seine Abschließendinstallationsaktionen nicht erfolgreich abschließen kann. Die Geräteinstallation sollte die Standardverarbeitung für die Anforderung ausführen. Co-Installer: Co-Installer dürfen diesen Fehlercode nicht zurückgeben. |
NO_ERROR |
Klasseninstallationsprogramm: Ein Klasseninstallationsprogramm sollte diesen Fehlercode nicht zurückgeben. Wenn ein Klasseninstallationsprogramm diesen Fehlercode zurückgibt, führt die Geräteinstallation nicht die Standardverarbeitung für die Anforderung aus. Co-Installationsprogramm: Das Installationsprogramm verfügt über keine Aktionen zum Abschließen der Installation, hat die Aktionen zum Abschließen der Installation erfolgreich abgeschlossen oder festgestellt, dass es seine Abschließendinstallationsaktionen nicht erfolgreich abschließen kann. |
Win32-Fehlercode |
Klasseninstallationsprogramm oder Co-Installer: Beim Installationsprogramm ist ein Fehler beim Verarbeiten einer Fertiginstallationsaktion aufgetreten, und die Geräteinstallation sollte versuchen, die Aktionen zum Beenden der Installation abzuschließen, wenn das Gerät das nächste Mal im Kontext eines Administrators aufgelistet wird. |
Standard-DIF-Codehandler
Windows 7 verwendet SetupDiFinishInstallAction.
Es gibt keinen DIF-Standardcodehandler in Windows 8 und höheren Versionen, und SetupDiFinishInstallAction wurde entfernt.
Kommentare
Da die Geräteinstallation nicht anhand eines ERROR_DI_DO_DEFAULT Rückgabecodes oder eines NO_ERROR Code zurückgeben kann, ob eine Fertiginstallationsaktion tatsächlich erfolgreich war, sollte das Installationsprogramm den Benutzer über die status einer Aktion des Fertiginstallationsprogramms benachrichtigen.
Weitere Informationen zu Fertiginstallationsaktionen finden Sie unter How Device Installation Processes Finish-Install Actions und Implementing Finish-Install Actions.
Allgemeine Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes und Aufrufen von DIF-Standardcodehandlern.
Requirements (Anforderungen)
Version |
Unterstützt in Windows Vista bis Windows 7. |
Header |
Setupapi.h (einschließlich Setupapi.h) |