SetupDiGetHwProfileList-Funktion (setupapi.h)
Die Funktion SetupDiGetHwProfileList ruft eine Liste aller derzeit definierten Hardwareprofil-IDs ab.
Syntax
WINSETUPAPI BOOL SetupDiGetHwProfileList(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex
);
Parameter
[out] HwProfileList
Ein Zeiger auf ein Array, um die Liste der derzeit definierten Hardwareprofil-IDs zu empfangen.
[in] HwProfileListSize
Die Anzahl der DWORDs im HwProfileList-Puffer .
[out] RequiredSize
Ein Zeiger auf eine Variable vom Typ DWORD, die die Anzahl der derzeit definierten Hardwareprofile empfängt. Wenn die Zahl größer als HwProfileListSize ist, wird die Liste an die Arraygröße angepasst. Der in RequiredSize zurückgegebene Wert gibt die Arraygröße an, die zum Speichern der gesamten Liste der Hardwareprofile erforderlich ist. In diesem Fall schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück.
[out, optional] CurrentlyActiveIndex
Ein Zeiger auf eine Variable vom Typ DWORD, die den Index des derzeit aktiven Hardwareprofils in der abgerufenen Hardwareprofilliste empfängt. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.
Hinweise
Rufen Sie SetupDiGetHwProfileListEx auf, um die Hardwareprofil-IDs für einen Remotecomputer abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |