Compartilhar via


Função CM_Get_Depth (cfgmgr32.h)

A função CM_Get_Depth é usada para obter a profundidade de um nó de dispositivo especificado (devnode) na árvore de dispositivos do computador local.

Sintaxe

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

Parâmetros

[out] pulDepth

Endereço fornecido pelo chamador de um local para receber um valor de profundidade, em que zero representa o nó raiz da árvore de dispositivos, um representa os filhos do nó raiz e assim por diante.

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib; OneCoreUAP.lib no Windows 10
DLL CfgMgr32.dll

Confira também

CM_Get_Child

CM_Get_Depth_Ex