Funzione SetupDiGetHwProfileListExA (setupapi.h)

  • Articolo

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

Sintassi

WINSETUPAPI BOOL SetupDiGetHwProfileListExA(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex,
  [in, optional]  PCSTR  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 in base 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 profilo hardware. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, l'elenco viene recuperato per il sistema locale.

Attenzione

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 la funzione 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.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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

Vedi anche

SetupDiGetHwProfileFriendlyNameEx