SetupInstallServicesFromInfSectionExW-Funktion (setupapi.h)

Artikel
11/20/2024

[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin für die Installation von Gerätetreibern verwendet.]

Die SetupInstallServicesFromInfSectionEx--Funktion führt Dienstinstallations- und Löschvorgänge aus, die in den Abschnitten Dienstinstallation im Abschnitt Service einer INF-Datei angegeben sind.

Ein Aufrufer dieser Funktion ist erforderlich, um Zugriff auf den Dienststeuerungs-Managerund Berechtigungen zum Ändern von Diensten zu haben.

Syntax

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionExW(
  [in] HINF             InfHandle,
  [in] PCWSTR           SectionName,
  [in] DWORD            Flags,
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
       PVOID            Reserved1,
       PVOID            Reserved2
);

Parameter

[in] InfHandle

Ein Handle für die INF-Datei, die den Abschnitt Service enthält.

[in] SectionName

Der Name des zu verarbeitenden Abschnitts Service. Sie sollten eine mit Null beendete Zeichenfolge verwenden.

[in] Flags

Die Steuerelemente für die Installation.

Flagge	Bedeutung
SPSVCINST_TAGTOFRONT 0x001	Verschieben Sie das Diensttag an den Anfang der Gruppenreihenfolgenliste.
SPSVCINST_ASSOCSERVICE 0x002	AddService-Abschnitt: Markieren Sie diesen Dienst als Funktionstreiber für das gerät, das installiert wird.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Löschen Sie den Ereignisprotokolleintrag für einen angegebenen Dienst.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Überschreiben Sie den Anzeigenamen nicht, wenn bereits vorhanden ist.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Überschreiben Sie den Starttypwert nicht, wenn der Dienst bereits vorhanden ist.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Überschreiben Sie den Fehlersteuerungswert nicht, wenn der Dienst bereits vorhanden ist.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Überschreiben Sie die Ladereihenfolgegruppe nicht, wenn sie bereits vorhanden ist.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Überschreiben Sie die Abhängigkeitsliste nicht, wenn sie bereits vorhanden ist.
SPSVCINST_NOCLOBBER_DESCRIPTION 0x100	AddService-Abschnitt: Markieren Sie diesen Dienst als Funktionstreiber für das gerät, das installiert wird.
SPSVCINST_STOPSERVICE 0x200	DelService-Abschnitt: Beenden Sie den im Eintrag angegebenen zugehörigen Dienst, bevor Sie den Dienst löschen.
SPSVCINST_CLOBBER_SECURITY 0x400	AddService-Abschnitt: Sicherheitseinstellungen, die der Dienst überschrieben wird, wenn der Dienst bereits im System vorhanden ist. Hinweis Ab Windows Server 2003 und Windows XP verfügbar.
SPSVCINST_STARTSERVICE 0x800	AddService-Abschnitt: Starten Sie den Dienst nach der Installation des Diensts. Dieses Flag kann nicht verwendet werden, um einen Dienst zu starten, der einen Plug and Play (PnP)-Funktionstreiber oder Filtertreiber für ein Gerät implementiert. Andernfalls kann dieses Flag verwendet werden, um einen Benutzermodus- oder Kernelmodusdienst zu starten, der vom Dienststeuerungs-Manager (SCM) verwaltet wird. Hinweis Ab Windows Server 2008 und Windows Vista verfügbar.
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES 0x1000	AddService-Abschnitt: Überschreiben Sie nicht die erforderlichen Berechtigungen des angegebenen Diensts, wenn der Dienst bereits im System vorhanden ist. Hinweis Ab Windows Server 2008 R2 und Windows 7 verfügbar.

[in] DeviceInfoSet

Ein optionaler Zeiger auf ein Handle auf einen Geräteinformationssatz. Weitere Informationen finden Sie im DDK-Programmierhandbuch. (Diese Ressource ist in einigen Sprachen möglicherweise nicht verfügbar.

und Länder.)

[in] DeviceInfoData

Ein optionaler Zeiger auf die SP_DEVINFO_DATA-Struktur, die einen Kontext zu einem bestimmten Element in der Gruppe bereitstellt, die DeviceInfoSet- angibt. Weitere Informationen finden Sie im DDK-Programmierhandbuch. (Diese Ressource ist in einigen Sprachen möglicherweise nicht verfügbar.

und Länder.)

Reserved1

Reserviert.

Reserved2

Reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Die Funktion ruft SetLastError mit ERROR_SUCCESS_REBOOT_REQUIRED auf, wenn ein Neustart des Systems erforderlich ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der Header setupapi.h definiert SetupInstallServicesFromInfSectionEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	setupapi.h
Library	Setupapi.lib
DLL-	Setupapi.dll

Siehe auch

Funktionen

Übersicht

SetupInstallFilesFromInfSection-

SetupInstallFromInfSection-

SetupInstallServicesFromInfSection

Freigeben über