SetupDiGetHwProfileList-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey