SetupSetFileQueueAlternatePlatformW-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 SetupSetFileQueueAlternatePlatform-Funktion ordnet die Dateiwarteschlange einer Zielplattform zu, die sich von der Plattform unterscheidet, auf der die Funktion ausgeführt wird. Dies erfolgt, um die Überprüfung nicht nativer Signaturen zu aktivieren.
Syntax
WINSETUPAPI BOOL SetupSetFileQueueAlternatePlatformW(
[in] HSPFILEQ QueueHandle,
[in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[in] PCWSTR AlternateDefaultCatalogFile
);
Parameter
[in] QueueHandle
Handle für eine geöffnete Setupdateiwarteschlange.
[in] AlternatePlatformInfo
Optionaler Zeiger auf eine SP_ALTPLATFORM_INFO Struktur, die Informationen zur alternativen Plattform übergibt. Unter Windows 2000 muss der cbSize-Member dieser Struktur auf sizeof(SP_ALTPLATFORM_INFO_V1) festgelegt werden. Unter Windows Server 2003 oder Windows XP muss der cbSize-Member dieser Struktur auf sizeof(SP_ALTPLATFORM_INFO_V2) festgelegt werden.
[in] AlternateDefaultCatalogFile
Zeiger auf eine NULL-endende Zeichenfolge, die einen Katalog angibt, der alle INF-Dateien überprüft. 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.
Hinweise
Hinweis
Der Setupapi.h-Header definiert SetupSetFileQueueAlternatePlatform 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
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für