funzione CM_Enumerate_Classes_Ex (cfgmgr32.h)

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Enumerate_Classes .]

La funzione CM_Enumerate_Classes_Ex , quando chiamata ripetutamente, enumera le classi di dispositivi installate di un computer locale o remoto, fornendo il GUID di ogni classe.

Sintassi

CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
  [in]           ULONG    ulClassIndex,
  [out]          LPGUID   ClassGuid,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[in] ulClassIndex

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

[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.

[in, optional] hMachine

Handle macchina fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

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 locali o remote di un computer remoto, chiamare ripetutamente CM_Enumerate_Classes_Ex , a partire da un valore di indice 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_Ex restituire. Prima di Windows 8, CM_Enumerate_Classes_Ex restituito solo le classi di configurazione del dispositivo.

Le funzionalità per accedere ai computer remoti sono state rimosse in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.

Requisiti

Vedi anche

CM_Enumerate_Classes