funzione CM_Get_Child (cfgmgr32.h)

Articolo
02/26/2024

La funzione CM_Get_Child viene usata per recuperare un handle di istanza del dispositivo al primo nodo figlio di un nodo dispositivo specificato (devnode) nell'albero dei dispositivi del computer locale.

Nota

In Windows Vista e versioni successive di Windows, il modello di proprietà del dispositivo unificato usa la chiave della proprietà DEVPKEY_Device_Children per rappresentare i figli del dispositivo. Per informazioni dettagliate, vedere Recupero delle relazioni dei dispositivi .

Sintassi

CMAPI CONFIGRET CM_Get_Child(
  [out] PDEVINST pdnDevInst,
  [in]  DEVINST  dnDevInst,
  [in]  ULONG    ulFlags
);

Parametri

[out] pdnDevInst

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

[in] dnDevInst

Handle di istanza del dispositivo fornito dal chiamante associato al computer locale.

[in] ulFlags

Non usato, deve essere zero.

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 del computer locale, chiamare prima CM_Get_Child per ottenere un handle di istanza del dispositivo al primo nodo figlio, quindi chiamare CM_Get_Sibling per ottenere handle per il resto dei figli.

Uso degli handle dell'istanza del dispositivo

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

Tutti gli handle dell'istanza locale del dispositivo 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 di istanza remota risultante è 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.

Per ottenere un handle di istanza del dispositivo associato al computer locale, eseguire una delle operazioni seguenti.

Usare una delle funzioni seguenti che recuperano solo gli handle dell'istanza locale del dispositivo: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent o CM_Get_Sibling.
Usare una delle funzioni seguenti, che recupera gli handle dell'istanza locale e remota del dispositivo, per recuperare un handle di istanza locale del dispositivo: 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 handle dell'istanza locale di dispositivi da un set di informazioni del dispositivo associato al computer locale. Eseguire i passaggi seguenti:

Ottenere un set di informazioni sul dispositivo associato al computer locale. Un handle di istanza del dispositivo ottenuto da un set di informazioni del 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 . Per un set di informazioni sul dispositivo locale associato al computer locale, il valore di RemoteMachineHandle è NULL. Chiamare SetupDiGetDeviceInfoListDetail per ottenere una struttura SP_DEVINFO_LIST_DETAIL_DATA.
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.

Requisiti

Requisito	Valore
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; OneCoreUAP.lib in Windows 10
DLL	CfgMgr32.dll