funzione CM_Locate_DevNode_ExA (cfgmgr32.h)

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

La funzione CM_Locate_DevNode_Ex ottiene un handle di istanza del dispositivo per il nodo del dispositivo associato a un ID istanza del dispositivo specificato, in un computer locale o in un computer remoto.

Sintassi

CMAPI CONFIGRET CM_Locate_DevNode_ExA(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

Parametri

[out] pdnDevInst

[in, optional] pDeviceID

[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 dei dispositivi o il dispositivo è un dispositivo nonpresente 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 per l'albero dei dispositivi. Se il dispositivo è in fase di rimozione, la funzione annulla la rimozione del dispositivo.

CM_LOCATE_DEVNODE_NOVALIDATION

Non usato.

[in, optional] hMachine

Handle del computer ottenuto da una chiamata a CM_Connect_Machine o da un handle del computer a cui è associato un set di informazioni sul dispositivo. L'handle del computer per un set di informazioni sul dispositivo viene ottenuto dal membro RemoteMachineHandle della struttura SP_DEVINFO_LIST_DETAIL_DATA per il set di informazioni sul dispositivo. Chiamare SetupDiGetDeviceInfoListDetail per ottenere una struttura SP_DEVINFO_LIST_DETAIL_DATA.

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 con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

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

Vedi anche

CM_Get_Child_Ex
CM_Locate_DevNode