funzione CM_Locate_DevNodeA (cfgmgr32.h)
La funzione CM_Locate_DevNode ottiene un handle di istanza del dispositivo per il nodo del dispositivo associato a un ID dell'istanza del dispositivo specificato nel computer locale.
Sintassi
CMAPI CONFIGRET CM_Locate_DevNodeA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags
);
Parametri
[out] pdnDevInst
Puntatore a un handle dell'istanza del dispositivo che CM_Locate_DevNode recupera. L'handle recuperato è associato al computer locale.
[in, optional] pDeviceID
Puntatore a una stringa con terminazione NULL che rappresenta un ID istanza del dispositivo . Se questo valore è NULLo se punta a una stringa di lunghezza zero, la funzione recupera un handle di istanza del dispositivo nel dispositivo alla radice dell'albero del dispositivo .
[in] ulFlags
Variabile di tipo ULONG che fornisce uno dei valori flag seguenti che si applicano se il chiamante fornisce un identificatore di istanza del dispositivo:
CM_LOCATE_DEVNODE_NORMAL
La funzione recupera l'handle dell'istanza del dispositivo per il dispositivo specificato solo se il dispositivo è attualmente configurato nell'albero dei dispositivi.
CM_LOCATE_DEVNODE_PHANTOM
La funzione recupera un handle di istanza del dispositivo per il dispositivo specificato se il dispositivo è attualmente configurato nell'albero dei dispositivi o il dispositivo è un dispositivo nonpresentato non configurato nell'albero dei dispositivi.
CM_LOCATE_DEVNODE_CANCELREMOVE
La funzione recupera un handle di istanza del dispositivo per il dispositivo specificato se il dispositivo è attualmente configurato nell'albero dei dispositivi o nel processo di rimozione dall'albero dei dispositivi. Se il dispositivo è in fase di rimozione, la funzione annulla la rimozione del dispositivo.
CM_LOCATE_DEVNODE_NOVALIDATION
Non utilizzato.
Valore restituito
Se l'operazione ha esito positivo, CM_Locate_DevNode restituisce CR_SUCCESS. In caso contrario, la funzione restituisce uno dei codici di errore CR_Xxx definiti in Cfgmgr32.h.
Osservazioni
Per informazioni sull'uso di handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.
Nota
L'intestazione cfgmgr32.h definisce CM_Locate_DevNode 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| piattaforma di destinazione | Universale |
| intestazione |
cfgmgr32.h (include Cfgmgr32.h) |
| libreria |
Cfgmgr32.lib |
| dll | CfgMgr32.dll |