funzione CM_Get_Sibling (cfgmgr32.h)

La funzione CM_Get_Sibling ottiene un handle di istanza del dispositivo al nodo di pari livello successivo 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_Siblings per rappresentare i fratelli del dispositivo. Per informazioni dettagliate, vedere Recupero delle relazioni dei dispositivi .

Sintassi

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

Parametri

[out] pdnDevInst

Puntatore fornito dal chiamante all'handle dell'istanza del dispositivo nel nodo di pari livello recuperato da questa funzione. L'handle recuperato è associato al computer locale.

[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 oggetto devnode nell'albero dei dispositivi del computer locale, chiamare prima CM_Get_Child per ottenere un handle al primo nodo figlio, quindi chiamare CM_Get_Sibling per ottenere handle per il resto degli elementi figlio.

Per informazioni sull'uso degli handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

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

Vedi anche

CM_Get_Child

CM_Get_Sibling_Ex