funzione CM_Get_Child_Ex (cfgmgr32.h)

Articolo
03/08/2023

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

La funzione CM_Get_Child_Ex viene usata per recuperare un handle di istanza del dispositivo nel primo nodo figlio di un nodo del dispositivo specificato (devnode) in un albero dei dispositivi locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Child_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[out] pdnDevInst

Puntatore fornito dal chiamante all'handle dell'istanza del dispositivo nel nodo figlio recuperato da questa funzione. L'handle recuperato è associato all'handle del computer fornito da hMachine. Vedere la sezione Osservazioni .

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato all'handle del computer fornito da hMachine.

[in] ulFlags

Non usato, deve essere zero.

[in, optional] hMachine

Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del dispositivo fornita dal chiamante.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

Per enumerare tutti gli elementi figlio di un nodo devnode nell'albero dei dispositivi di un computer locale o remoto, chiamare prima CM_Get_Child_Ex per ottenere un handle al primo nodo figlio, quindi chiamare CM_Get_Sibling_Ex per ottenere handle per il resto degli elementi figlio.

Uso degli handle dell'istanza del dispositivo

L'handle dell'istanza del dispositivo usato con le funzioni di gestione della configurazione PnP è associato agli handle del computer, come indicato di seguito:

Tutti gli handle di istanza del dispositivo locale sono associati a un handle di computer locale con valori NULL.
Se si usa un handle di computer remoto per ottenere un handle di istanza del dispositivo, l'handle dell'istanza del dispositivo remoto risultante viene associato all'handle del computer remoto.
Un handle di istanza del dispositivo può essere usato solo con l'handle del computer a cui è associato.
Un handle di istanza del dispositivo può essere usato con un altro handle di istanza del dispositivo solo se entrambi gli handle di istanza del dispositivo sono associati allo stesso handle del computer.

Usare CM_Connect_Machine per ottenere un handle di computer remoto da usare con handle di istanza del dispositivo remoto.

Per ottenere un handle di istanza locale o remota del dispositivo, eseguire una delle operazioni seguenti.

Usare una delle funzioni seguenti per recuperare un handle di istanza del dispositivo associato al computer locale: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent o CM_Get_Sibling.
Usare una delle funzioni seguenti per recuperare un handle di istanza del dispositivo associato a un computer locale o remoto: CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex o CM_Get_Sibling_Ex.

È anche possibile usare le funzioni di installazione del dispositivo per ottenere gli handle dell'istanza del dispositivo. Eseguire i passaggi seguenti:

Ottenere un set di informazioni sul dispositivo.
Ottenere una struttura SP_DEVINFO_DATA per un'istanza del dispositivo nel set di informazioni sul dispositivo.
Ottenere l'handle dell'istanza del dispositivo per l'istanza del dispositivo dal membro DevInst della struttura SP_DEVINFO_DATA.
Ottenere l'handle del computer a cui è associato l'handle dell'istanza del dispositivo. Un handle di istanza del dispositivo ottenuto da un set di informazioni sul dispositivo è associato all'handle del computer a cui è associato il set di informazioni sul dispositivo. Si ottiene l'handle del computer per un set di informazioni sul dispositivo dal membro RemoteMachineHandle della relativa struttura SP_DEVINFO_LIST_DETAIL_DATA . Chiamare SetupDiGetDeviceInfoListDetail per ottenere una struttura SP_DEVINFO_LIST_DETAIL_DATA.

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

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib
DLL	Cfgmgr32.dll