SetupSetPlatformPathOverrideW-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 für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupSetPlatformPathOverride-Funktion wird verwendet, um eine Plattformpfadüberschreibung für einen Zielcomputer festzulegen, wenn mit INFs von einem anderen Computer aus gearbeitet wird. Daher kann es sich auf eine andere Plattform beziehen, als sie derzeit ausgeführt wird. Für den Umgang mit Medienquellen kann es sich auf Plattformen beziehen, die nicht mehr unterstützt werden, z. B. Alpha, MIPS und PPC. Es entfernt das Überschreiben des Plattformpfads, wenn keine angegeben ist.

Syntax

WINSETUPAPI BOOL SetupSetPlatformPathOverrideW(
  [in] PCWSTR Override
);

Parameter

[in] Override

Zeiger auf eine NULL-beendete Zeichenfolge, die die Informationen zur Ersatzplattform enthält. Beispiel: "alpha" oder "x86". Dieser Parameter kann NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Wenn GetLastError ERROR_NOT_ENOUGH_MEMORY zurückgibt, konnte SetupSetPlatformPathOverride die Außerkraftsetzungszeichenfolge nicht speichern.

Hinweise

SetPlatformPathOverride wird verwendet, um den Quellpfad beim Anstellen von Dateien zu ändern. Wenn eine Plattformpfadüberschreibung durch einen Aufruf von SetPlatformPathOverride festgelegt wurde, untersucht jede Setupfunktion, die Dateikopievorgänge in Warteschlangen angibt, die letzte Komponente des Quellpfads. Wenn die letzte Komponente mit dem Namen der Plattform des Benutzers übereinstimmt, ersetzen Sie sie durch die von SetPlatformPathOverride festgelegte Überschreibungszeichenfolge.

Betrachten Sie beispielsweise einen MIPS-Plattformcomputer, auf dem die Plattform durch einen Aufruf von SetPlatformPathOverride auf Alpha festgelegt wurde. Nachdem die Plattformpfadüberschreibung festgelegt wurde, wird ein Dateikopiervorgang mit einem Quellpfad von \pop\top\baz\mips\x.exe in die Warteschlange gestellt. Der Pfad wird in \pop\top\baz\alpha\x.exe geändert.

Die Pfade von Dateikopiervorgängen, die vor dem Festlegen der Pfadüberschreibung in die Warteschlange gestellt werden, werden nicht geändert.

Hinweis

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

SetupSetDirectoryId