Share via

SetupPromptReboot-Funktion (setupapi.h)

  • Artikel

[Diese Funktion ist für die Verwendung in den betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupPromptReboot-Funktion fragt den Benutzer, ob er das System neu starten möchte, optional abhängig davon, ob Dateien in einer committeten Dateiwarteschlange während eines Dateivorgangs verwendet wurden. Wenn der Benutzer auf die Eingabeaufforderung mit "Ja" antwortt, wird das Herunterfahren initiiert, bevor diese Routine zurückgegeben wird.

Syntax

WINSETUPAPI INT SetupPromptReboot(
  [in] HSPFILEQ FileQueue,
  [in] HWND     Owner,
  [in] BOOL     ScanOnly
);

Parameter

[in] FileQueue

Optionaler Zeiger auf ein Handle auf die Dateiwarteschlange, auf der die Entscheidung darüber basieren soll, ob das Herunterfahren erforderlich ist. Wenn FileQueue nicht angegeben ist, geht SetupPromptReboot davon aus, dass das Herunterfahren erforderlich ist, und fragt den Benutzer, was zu tun ist.

[in] Owner

Handle für das übergeordnete Fenster für eigene Fenster, die von dieser Funktion erstellt wurden.

[in] ScanOnly

Gibt an, ob der Benutzer beim Aufrufen von SetupPromptReboot aufgefordert werden soll.

Bei TRUE wird der Benutzer nie nach einem Neustart gefragt, und das Herunterfahren des Systems wird nicht initiiert. In diesem Fall muss FileQueue angegeben werden. Bei FALSE wird der Benutzer wie zuvor beschrieben nach einem Neustart gefragt.

Verwenden Sie ScanOnly , um zu ermitteln, ob das Herunterfahren getrennt vom tatsächlichen Starten eines Herunterfahrens erforderlich ist.

Rückgabewert

Die Funktion gibt eine Kombination der folgenden Flags oder –1 zurück, wenn ein Fehler auftritt.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile setupapi.h
Bibliothek Setupapi.lib
DLL Setupapi.dll

Siehe auch

Funktionen

Übersicht

SetupPromptForDisk