funzione CM_Add_ID_ExA (cfgmgr32.h)

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

La funzione CM_Add_ID_Ex aggiunge un ID dispositivo (se non è già presente) all'elenco di ID hardware di un'istanza del dispositivo o all'elenco id compatibile , nel computer locale o in un computer remoto.

Sintassi

CMAPI CONFIGRET CM_Add_ID_ExA(
  DEVINST  dnDevInst,
  PSTR     pszID,
  ULONG    ulFlags,
  HMACHINE hMachine
);

Parametri

dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato all'handle del computer fornito da hMachine.

pszID

Puntatore fornito dal chiamante a una stringa ID dispositivo con terminazione NULL.

ulFlags

Costante flag fornita dal chiamante che specifica l'elenco in cui deve essere aggiunto l'ID dispositivo fornito. Le costanti del flag seguenti sono valide.

Costante Flag	Definizione
CM_ADD_ID_COMPATIBLE	L'ID dispositivo specificato deve essere aggiunto all'elenco di ID compatibili dell'istanza del dispositivo specifico.
CM_ADD_ID_HARDWARE	L'ID dispositivo specificato deve essere aggiunto all'elenco di ID hardware dell'istanza del dispositivo specifico.

hMachine

Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del dispositivo fornita dal chiamante.

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

 

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

Ogni ID dispositivo aggiunto viene considerato meno compatibile rispetto agli ID già esistenti nell'elenco specificato. Per informazioni sugli ID dispositivo, gli ID hardware e gli ID compatibili, vedere Stringhe di identificazione del dispositivo.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Per informazioni sull'uso di handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.

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

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib

Vedi anche

CM_Add_ID
CM_Get_Child_Ex