SetupDiGetActualSectionToInstallExW-Funktion (setupapi.h)

  • Artikel

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 SetupDiGetActualSectionToInstallExW(
  [in]            HINF                 InfHandle,
  [in]            PCWSTR               InfSectionName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PWSTR                InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
  [out, optional] PWSTR                *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

Weitere Informationen

ABSCHNITT INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice