SetupDiGetActualSectionToInstallExA-Funktion (setupapi.h)
Die SetupDiGetActualSectionToInstallEx-Funktion ruft den Namen des INF DDInstall-Abschnitts ab, der ein Gerät für eine angegebene Betriebssystem- und Prozessorarchitektur installiert.
Syntax
WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
[in] HINF InfHandle,
[in] PCSTR InfSectionName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
[out, optional] PSTR *Extension,
PVOID Reserved
);
Parameter
[in] InfHandle
Ein Handle für die INF-Datei, die den Abschnitt DDInstall enthält.
[in] InfSectionName
Ein Zeiger auf den DDInstall-Abschnittsnamen (wie in einem Abschnitt in INF-Modelle angegeben). Die maximale Länge des Abschnittsnamens in Zeichen beträgt 254.
[in, optional] AlternatePlatformInfo
Ein Zeiger, wenn nicht NULL, auf eine SP_ALTPLATFORM_INFO Struktur. Diese Struktur wird verwendet, um eine Betriebssystem- und Prozessorarchitektur anzugeben, die sich von der Architektur auf dem lokalen Computer unterscheidet. Um den DDInstall-Abschnittsnamen für den lokalen Computer zurückzugeben, legen Sie diesen Parameter auf NULL fest. Geben Sie andernfalls eine SP_ALTPLATFORM-Struktur an, und legen Sie deren Member wie folgt fest:
cbSize
Legen Sie die Größe einer SP_ALTPLATFORM_INFO-Struktur in Bytes fest.
Plattform
Legen Sie für Windows XP und höhere Versionen von Windows auf VER_PLATFORM_WIN32_NT fest.
MajorVersion
Wird nicht verwendet.
MinorVersion
Wird nicht verwendet.
ProcessorArchitecture
Legen Sie eine der folgenden Prozessorarchitekturkonstanten fest.
| Prozessorarchitekturkonstante | Bedeutung |
|---|---|
| PROCESSOR_ARCHITECTURE_INTEL | Die alternative Plattform ist eine x86-basierte Prozessorarchitektur. |
| PROCESSOR_ARCHITECTURE_IA64 | Die alternative Plattform ist eine Itanium-basierte Prozessorarchitektur. |
| PROCESSOR_ARCHITECTURE_AMD64 | Die alternative Plattform ist eine x64-basierte Prozessorarchitektur. |
Reserviert
Auf NULL festlegen.
[out, optional] InfSectionWithExt
Ein Zeiger auf einen Zeichenpuffer zum Empfangen des DDInstall-Abschnittsnamens , seiner Plattformerweiterung und eines NULL-Abschlussators. Dies ist der dekorierte Abschnittsname, der für die Installation verwendet werden sollte. Wenn dieser Parameter NULL ist, gibt die Funktion TRUE zurück und legt RequiredSize auf die Größe in Zeichen fest, die erforderlich ist, um den Namen des DDInstall-Abschnitts , seine Plattformerweiterung und ein beendendes NULL-Zeichen zurückzugeben.
[in] InfSectionWithExtSize
Die Größe des Puffers in Zeichen, auf den der Parameter InfSectionWithExt verweist. Die maximale Länge eines MIT NULL beendeten INF-Abschnittsnamens in Zeichen ist MAX_INF_SECTION_NAME_LENGTH.
[out, optional] RequiredSize
Ein Zeiger auf die Variable, die die Größe in Zeichen empfängt, die erforderlich ist, um den DDInstall-Abschnittsnamen , die Plattformerweiterung und ein beendendes NULL-Zeichen zurückzugeben.
[out, optional] Extension
Ein Zeiger auf eine Variable, die einen Zeiger auf das Zeichen "." empfängt, das den Anfang der Erweiterung im Puffer InfSectionWithExt markiert. Wenn der InfSectionWithExt-Puffer nicht oder zu klein ist, wird dieser Parameter nicht festgelegt. Legen Sie diesen Parameter auf NULL fest, wenn kein Zeiger auf die Erweiterung erforderlich ist.
Reserved
Nur für die interne Verwendung vorgesehen. Muss auf NULL festgelegt werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
SetupDiGetActualSectionToInstallEx ist eine erweiterte Form von SetupDiGetActualSectionToInstall. Diese Funktionen unterstützen die Erweiterungen von DDInstall-Abschnittsnamen , die verwendet werden, um betriebssystemspezifische und architekturspezifische Installationsaktionen für ein Gerät anzugeben. Informationen zu diesen Erweiterungen finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme.
Wenn Sie keine alternativen Plattforminformationen mit einem Aufruf von SetupDiGetActualSectionToInstallEx bereitstellen, führt die Funktion denselben Vorgang wie SetupDiGetActualSectionToInstall aus. Die letztere Funktion sucht anhand der Plattforminformationen für den lokalen Computer nach dem angegebenen Namen des Installationsabschnitts.
Wenn Sie Informationen zur alternativen Plattform mit einem Aufruf von SetupDiGetActualSectionToInstallEx bereitstellen, führt die Funktion folgendes aus:
-
Wenn Sie eine Plattform mit VER_PLATFORM_WIN32_NT angeben, sucht die Funktion zunächst in der angegebenen INF-Datei nach einem Namen des dekorierten Installationsabschnitts, der dem von Ihnen angegebenen Namen, dem Betriebssystem und der Prozessorarchitektur entspricht. Wenn Sie beispielsweise einen Installationsabschnittsnamen von InstallSec angeben, sucht die Funktion abhängig von der angegebenen Prozessorarchitektur nach einem der folgenden dekorierten Namen:
- Wenn Sie die x86-basierte Prozessorarchitektur angeben, sucht die Funktion nach dem dekorierten Namen InstallSec.ntx86.
- Wenn Sie die x64-basierte Prozessorarchitektur angeben, sucht die Funktion nach dem dekorierten Namen InstallSec.ntamd64.
- Wenn Sie die Itanium-basierte Prozessorarchitektur angeben, sucht die Funktion nach dem dekorierten Namen InstallSec.ntia64.
Wenn die Funktion eine Übereinstimmung für den Namen, das Betriebssystem und die Prozessorarchitektur findet, beendet sie die Suche und gibt den entsprechenden dekorierten Namen zurück. Wenn die Funktion eine solche Übereinstimmung nicht findet, sucht die Funktion nach einem Abschnitt mit dem Namen InstallSec.nt. Wenn die Funktion eine Übereinstimmung für InstallSec.nt findet, beendet sie die Suche und gibt diesen Namen zurück. Wenn die Funktion keine Übereinstimmung für eine der oben genannten Suchvorgänge findet, gibt sie InstallSec zurück, überprüft aber nicht, ob die INF-Datei einen Installationsabschnitt enthält, dessen Name InstallSec lautet.
Hinweis
Der setupapi.h-Header definiert SetupDiGetActualSectionToInstallEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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) | Verfügbar in Windows XP und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |