funzione CM_Enumerate_Classes (cfgmgr32.h)

La funzione CM_Enumerate_Classes , quando viene chiamata ripetutamente, enumera le classi di dispositivi installate del computer locale fornendo il GUID di ogni classe.

Sintassi

CMAPI CONFIGRET CM_Enumerate_Classes(
  [in]  ULONG  ulClassIndex,
  [out] LPGUID ClassGuid,
  [in]  ULONG  ulFlags
);

Parametri

[in] ulClassIndex

Indice fornito dal chiamante nell'elenco delle classi di dispositivi del computer. Per altre informazioni, vedere la sezione Osservazioni .

[out] ClassGuid

Indirizzo fornito dal chiamante di una struttura GUID (descritto nella Microsoft Windows SDK) per ricevere il GUID di una classe di dispositivi.

[in] ulFlags

A partire da Windows 8, i chiamanti possono specificare i flag seguenti:

CM_ENUMERATE_CLASSES_INSTALLER

Enumerare le classi di installazione del dispositivo.

CM_ENUMERATE_CLASSES_INTERFACE

Enumerare le classi dell'interfaccia del dispositivo.

In caso contrario, deve essere impostato su zero.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

Per enumerare le classi di dispositivo del computer locale, chiamare ripetutamente CM_Enumerate_Classes , a partire da un valore ulClassIndex pari a zero e incrementando il valore di indice con ogni chiamata successiva fino a quando la funzione non restituisce CR_NO_SUCH_VALUE. Alcuni valori di indice potrebbero rappresentare voci di elenco contenenti dati di classe non validi, nel qual caso la funzione restituisce CR_INVALID_DATA. Questo valore restituito può essere ignorato.

I GUID di classe ottenuti da questa funzione possono essere usati come input per le funzioni di installazione del dispositivo.

A partire da Windows 8 e sistemi operativi successivi, i chiamanti possono usare il membro ulFlags per specificare quali classi di dispositivi CM_Enumerate_Classes restituire. Prima di Windows 8, CM_Enumerate_Classes restituito solo le classi di configurazione del dispositivo.

Requisiti

Vedi anche

CM_Enumerate_Classes_Ex