funzione CM_Add_ID_ExW (cfgmgr32.h)

Articolo
02/23/2024

[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 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_ExW(
  [in]           DEVINST  dnDevInst,
  [in]           PWSTR    pszID,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[in] dnDevInst

Handle di istanza del dispositivo fornito dal chiamante associato all'handle del computer fornito da

hMachine

[in] pszID

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

[in] ulFlags

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

Contrassegna costante	Definizione
CM_ADD_ID_COMPATIBLE	L'ID dispositivo specificato deve essere aggiunto all'elenco ID compatibile dell'istanza del dispositivo specifico.
CM_ADD_ID_HARDWARE	L'ID dispositivo specificato deve essere aggiunto all'elenco ID hardware dell'istanza del dispositivo specifico.

[in, optional] hMachine

Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del chiamante fornito 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 è 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 degli handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.

La funzionalità per accedere ai computer remoti è stata rimossa in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti quando vengono eseguiti 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

Condividi tramite