funzione CM_Locate_DevNode_ExW (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 nel 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_ExW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

Parametri

[out] pdnDevInst

Puntatore all'istanza del dispositivo gestito da questa funzione. L'handle recuperato è associato all'handle del computer specificato da hMachine.

[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 fornisce un handle dell'istanza del dispositivo al dispositivo nella 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 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 di computer ottenuto da una chiamata a CM_Connect_Machine o un handle di 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 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 versioni successive, pertanto non è possibile accedere ai computer remoti quando in esecuzione in queste versioni di Windows.

Requisiti

Vedi anche

CM_Get_Child_Ex

CM_Locate_DevNode