SetupInstallServicesFromInfSectionExA-Funktion (setupapi.h)

[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 SetupInstallServicesFromInfSectionEx-Funktion führt Dienstinstallations- und Löschvorgänge aus, die in den Abschnitten "Dienstinstallation" einer INF-Datei angegeben sind.

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

Syntax

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            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 Dienstabschnitts . Sie sollten eine NULL-endende Zeichenfolge verwenden.

[in] Flags

Die Steuerelemente für die Installation.

Flag Bedeutung
SPSVCINST_TAGTOFRONT
0x001
Verschieben Sie das Diensttag an den Anfang seiner Gruppenreihenfolgenliste.
SPSVCINST_ASSOCSERVICE
0x002
AddService-Abschnitt: Markieren Sie diesen Dienst als Funktionstreiber für das zu installierende Gerät.
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 Fehlerkontrollwert 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 zu installierende Gerät.
SPSVCINST_STOPSERVICE
0x200
DelService-Abschnitt: Beenden Sie den zugeordneten Dienst, der im Eintrag angegeben ist, bevor Sie den Dienst löschen.
SPSVCINST_CLOBBER_SECURITY
0x400
Abschnitt AddService: Sicherheitseinstellungen, die der Dienst überschrieben wird, wenn der Dienst bereits im System vorhanden ist.
Hinweis Verfügbar ab Windows Server 2003 und Windows XP.
 
SPSVCINST_STARTSERVICE
0x800
AddService-Abschnitt: Starten Sie den Dienst, nachdem der Dienst installiert wurde. Dieses Flag kann nicht verwendet werden, um einen Dienst zu starten, der einen PnP-Funktionstreiber (Plug & Play) oder einen Filtertreiber für ein Gerät implementiert. Andernfalls kann dieses Flag verwendet werden, um einen Benutzermodus- oder Kernelmodusdienst zu starten, der vom Service Control Manager (SCM) verwaltet wird.
Hinweis Verfügbar ab Windows Server 2008 und Windows Vista.
 
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
0x1000
AddService-Abschnitt: Überschreiben Sie die erforderlichen Berechtigungen des angegebenen Diensts nicht, wenn der Dienst bereits im System vorhanden ist.
Hinweis Verfügbar ab Windows Server 2008 R2 und Windows 7.
 

[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 für ein bestimmtes Element in der von DeviceInfoSet angegebenen Gruppe bereitstellt. 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 fehlerhaft ist, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der setupapi.h-Header 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
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

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection