CM_Get_Depth-Funktion (cfgmgr32.h)

Die CM_Get_Depth-Funktion wird verwendet, um die Tiefe eines angegebenen Geräteknotens (Devnode) innerhalb der Gerätestruktur des lokalen Computers abzurufen.

Syntax

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

Parameter

[out] pulDepth

Vom Aufrufer bereitgestellte Adresse eines Standorts, um einen Tiefenwert zu erhalten, wobei null den Stammknoten der Gerätestruktur, einer für die untergeordneten Elemente des Stammknotens usw. darstellt.

[in] dnDevInst

Vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulFlags

Nicht verwendet, muss null sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

Weitere Informationen

CM_Get_Child

CM_Get_Depth_Ex