funzione CM_Locate_DevNodeA (cfgmgr32.h)
La funzione CM_Locate_DevNode ottiene un handle di istanza del dispositivo nel nodo del dispositivo associato a un ID 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 di 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 è NULL o se punta a una stringa di lunghezza zero, la funzione recupera un handle dell'istanza del dispositivo nel dispositivo alla radice dell'albero del dispositivo.
[in] ulFlags
Variabile di tipo ULONG che fornisce uno dei valori di 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 del dispositivo o il dispositivo è un dispositivo nonpresente che non è attualmente 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 del dispositivo 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 usato.
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.
Commenti
Per informazioni sull'uso degli 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| 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 |