SetupSetPlatformPathOverrideA-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 SetupSetPlatformPathOverride-Funktion wird verwendet, um eine Plattformpfadüberschreibung für einen Zielcomputer festzulegen, wenn sie mit INFs von einem anderen Computer aus arbeiten. Daher kann sie auf eine andere Plattform verweisen, als sie derzeit ausgeführt wird. Für den Umgang mit Medienquellen kann er sich auf Plattformen beziehen, die nicht mehr unterstützt werden, z. B. Alpha, MIPS und PPC. Es entfernt die Plattformpfadüberschreibung, wenn keine angegeben ist.
Syntax
WINSETUPAPI BOOL SetupSetPlatformPathOverrideA(
[in] PCSTR Override
);
Parameter
[in] Override
Zeiger auf eine NULL-endende 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 Wert ungleich null.
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 zu ändern, wenn Dateien in die Warteschlange gestellt werden. Wenn eine Plattformpfadüberschreibung durch einen Aufruf von SetPlatformPathOverride festgelegt wurde, überprüft jede Setupfunktion, die Dateikopiervorgänge in die Warteschlange stellt, die letzte Komponente des Quellpfads, und 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 dem Quellpfad \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 Header setupapi.h definiert SetupSetPlatformPathOverride 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 |