funzione CM_Locate_DevNodeA (cfgmgr32.h)

  • Articolo

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

Vedi anche

CM_Get_Child

CM_Locate_DevNode_Ex