SetupDiSetClassInstallParamsW-Funktion (setupapi.h)
Die SetupDiSetClassInstallParams Funktionssätze oder Löscht Klasseninstallationsparameter für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement.
Syntax
WINSETUPAPI BOOL SetupDiSetClassInstallParamsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
[in] DWORD ClassInstallParamsSize
);
Parameter
[in] DeviceInfoSet
Ein Handle zum Geräteinformationssatz, für den Klasseninstallationsparameter festgelegt werden sollen.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur, die das Gerät darstellt, für das Klasseninstallationsparameter festgelegt werden sollen. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, legt SetupDiSetClassInstallParams die Klasseninstallationsparameter für das angegebene Gerät fest. Wenn dieser Parameter NULL-ist, legt SetupDiSetClassInstallParams die Klasseninstallationsparameter fest, die DeviceInfoSet-zugeordnet sind.
[in, optional] ClassInstallParams
Ein Zeiger auf einen Puffer, der die neuen zu verwendenden Klasseninstallationsparameter enthält. Die SP_CLASSINSTALL_HEADER Struktur am Anfang dieses Puffers muss die cbSize Feld auf Sizeof(SP_CLASSINSTALL_HEADER) festgelegt haben, und das feld InstallFunction muss auf den DI_FUNCTION Code festgelegt werden, der den Typ der parameter im restlichen Puffer enthält.
Wenn ClassInstallParams nicht angegeben ist, werden die aktuellen Klasseninstallationsparameter (falls vorhanden) für den angegebenen Geräteinformationssatz oder -element gelöscht.
[in] ClassInstallParamsSize
Die Größe des ClassInstallParams- Puffers in Byte. Wenn der Puffer nicht angegeben wird (d. h. die Klasseninstallationsparameter werden gelöscht), muss ClassInstallParamsSize 0sein.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastErrorabgerufen werden.
Bemerkungen
Alle Parameter werden überprüft, bevor Änderungen vorgenommen werden. Daher gibt ein Rückgabewert von FALSE an, dass keine Parameter geändert wurden.
Ein Nebeneffekt des Festlegens von Klasseninstallationsparametern besteht darin, dass das DI_CLASSINSTALLPARAMS Flag festgelegt ist. Wenn der Aufrufer die Parameter festlegen möchte, die Verwendung jedoch deaktivieren möchte, muss dieses Flag durch einen Aufruf von SetupDiSetDeviceInstallParamsgelöscht werden.
Wenn die Parameter für die Klasseninstallation gelöscht werden, wird das DI_CLASSINSTALLPARAMS Flag zurückgesetzt.
Anmerkung
Der Header setupapi.h definiert SetupDiSetClassInstallParams 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 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |
| API-Satz | ext-ms-win-setupapi-classinstallers-l1-1-0 (eingeführt in Windows 8) |