funzione CM_Get_Depth (cfgmgr32.h)

La funzione CM_Get_Depth viene usata per ottenere la profondità di un nodo del dispositivo specificato (devnode) all'interno dell'albero dei dispositivi del computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_Depth(
  [out] PULONG  pulDepth,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Parametri

[out] pulDepth

Indirizzo fornito dal chiamante di una posizione per ricevere un valore di profondità, in cui zero rappresenta il nodo radice dell'albero del dispositivo, uno rappresenta i figli del nodo radice e così via.

[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 informazioni sull'uso degli handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Vedi anche

CM_Get_Child

CM_Get_Depth_Ex