Funzione SetupDiGetHwProfileList (setupapi.h)

La funzione SetupDiGetHwProfileList recupera un elenco di tutti gli ID profilo hardware attualmente definiti.

Sintassi

WINSETUPAPI BOOL SetupDiGetHwProfileList(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex
);

Parametri

[out] HwProfileList

Puntatore a una matrice per ricevere l'elenco di ID profilo hardware attualmente definiti.

[in] HwProfileListSize

Numero di DWORD nel buffer HwProfileList .

[out] RequiredSize

Puntatore a una variabile di tipo DWORD che riceve il numero di profili hardware attualmente definiti. Se il numero è maggiore di HwProfileListSize, l'elenco viene troncato per adattare le dimensioni della matrice. Il valore restituito in RequiredSize indica la dimensione della matrice necessaria per archiviare l'intero elenco di profili hardware. In questo caso, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.

[out, optional] CurrentlyActiveIndex

Puntatore a una variabile di tipo DWORD che riceve l'indice del profilo hardware attualmente attivo nell'elenco dei profili hardware recuperati. Questo parametro è facoltativo e può essere NULL.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.

Commenti

Chiamare SetupDiGetHwProfileListEx per recuperare gli ID profilo hardware per un computer remoto.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (includere Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey