Funzione SetupDiGetHwProfileListExW (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiGetHwProfileListEx recupera un elenco di tutti gli ID del profilo hardware attualmente definiti in un computer locale o remoto.

Sintassi

WINSETUPAPI BOOL SetupDiGetHwProfileListExW(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex,
  [in, optional]  PCWSTR MachineName,
                  PVOID  Reserved
);

Parametri

[out] HwProfileList

Puntatore a una matrice per ricevere l'elenco degli ID del 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 adattarsi alle dimensioni della matrice. Il valore restituito in RequiredSize indica le dimensioni della matrice necessarie per archiviare l'intero elenco di profili hardware.

[out, optional] CurrentlyActiveIndex

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

[in, optional] MachineName

Puntatore a una stringa con terminazione NULL contenente il nome di un sistema remoto per il quale recuperare l'elenco di ID del profilo hardware. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, l'elenco viene recuperato per il sistema locale.

Cautela

L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

Reserved

Deve essere null.

Valore restituito

Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError. Se la dimensione richiesta è maggiore di HwProfileListSize, SetupDiGetHwProfileListEx restituisce FALSE e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.

Osservazioni

Nota

L'intestazione setupapi.h definisce SetupDiGetHwProfileListEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	setupapi.h (include Setupapi.h)
libreria	Setupapi.lib

Vedere anche

SetupDiGetHwProfileFriendlyNameEx

Condividi tramite