InstallHinfSectionA-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.]

InstallHinfSection ist eine Einstiegspunktfunktion, die von Setupapi.dll exportiert wird, mit der Sie einen Abschnitt einer INF-Datei ausführen können. InstallHinfSection kann aufgerufen werden, indem das Hilfsprogramm Rundll32.exe aufgerufen wird, wie im Abschnitt Hinweise beschrieben.

Der Prototyp für die InstallHinfSection-Funktion folgt der Form aller Einstiegspunktfunktionen, die mit Rundll32.exe verwendet werden.

Wenn eine Datei kopiert oder geändert wird, muss der Aufrufer dieser Funktion über Berechtigungen zum Schreiben in das Zielverzeichnis verfügen. Wenn Dienste installiert werden, muss der Aufrufer dieser Funktion Zugriff auf den Dienststeuerungs-Manager haben.

Syntax

void InstallHinfSectionA(
  [in] HWND      Window,
  [in] HINSTANCE ModuleHandle,
  [in] PCSTR     CommandLine,
  [in] INT       ShowCommand
);

Parameter

[in] Window

Das Handle des übergeordneten Fensters. In der Regel ist hwnd Null.

[in] ModuleHandle

Reserviert und sollte NULL sein.

[in] CommandLine

Zeiger auf den Puffer, der die Befehlszeile enthält. Sie sollten eine NULL-endende Zeichenfolge verwenden.

[in] ShowCommand

Reserviert und sollten null sein.

Rückgabewert

Keine

Bemerkungen

Beachten Sie, dass drei Exporte vorhanden sind: InstallHinfSection (für RunDll32), InstallHinfSectionA und InstallHinfSectionW.

Um einen Installationsabschnitt einer angegebenen INF-Datei auszuführen, können Sie InstallHinfSection mit der Rundll32.exe aufrufen, indem Sie die folgende Syntax verwenden.

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection-Abschnittsmoduspfad <><><>

Dadurch wird der Abschnittsmoduspfad<><><> an CmdLineBuffer übergeben.

Alternativ kann Ihr Programm InstallHinfSection, InstallHinfSectionA oder InstallHinfSectionW direkt aufrufen und den CmdLineBuffer-Parameter auf Folgendes festlegen.

"<section> <mode> <path>"

Dabei ist path der vollständige Pfad zur INF-Datei, modus ist der Neustartmodusparameter, und der Abschnitt ist ein beliebiger Installationsabschnitt in der INF-Datei. Das Kommatrennzeichen zwischen SETUPAPI.DLL und InstallHinfSection in der Befehlszeile ist erforderlich. Beachten Sie, dass keine Leerzeichen in der Befehlszeile zwischen dem Komma und SETUPAPI.DLL oder InstallHinfSection vorhanden sind.

Es wird empfohlen, den vollständigen Pfad zur INF-Datei als Pfad anzugeben.

Sie können jeden Installationsabschnitt in der INF-Datei als -Abschnitt angeben. Leerzeichen sind nicht zulässig.

Sie sollten eine Kombination der folgenden Werte für den Modus verwenden. Sie müssen 128 einschließen, um den Standardpfad der Installation auf den Speicherort des INF festzulegen, andernfalls wird von einem vom System bereitgestellten INF ausgegangen. Fügen Sie Werte hinzu, um einen Neustart anzugeben. Beachten Sie, dass nur die Werte 128 oder 132 empfohlen werden. Andere Werte können dazu führen, dass der Computer unnötig neu gestartet wird oder nicht neu gestartet wird, wenn dies erforderlich ist.

Die folgende Befehlszeile führt beispielsweise den Abschnitt DefaultInstall der Datei Shell.inf aus. Wenn setup feststellt, dass ein Neustart erforderlich ist, wird der Benutzer mit dem Dialogfeld "Computer neu starten, Ja/Nein" aufgefordert.

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection DefaultInstall 132 C:\WINDOWS\INF\SHELL. INF

Anforderungen