função CM_Get_Parent (cfgmgr32.h)

  • Artigo

A função CM_Get_Parent obtém um identificador de instância de dispositivo para o nó pai de um nó de dispositivo especificado (devnode) na árvore de dispositivos do computador local.

Observação

No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado usa a chave de propriedadeDEVPKEY_Device_Parent para representar o pai do dispositivo. Consulte Recuperando relações de dispositivo para obter detalhes.

Sintaxe

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

Parâmetros

[out] pdnDevInst

Ponteiro fornecido pelo chamador para o identificador da instância do dispositivo para o nó pai que essa função recupera. O identificador recuperado está associado ao computador local.

[in] dnDevInst

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

[in] ulFlags

Não usado, deve ser zero.

Valor retornado

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 um identificador de instância de dispositivo associado ao computador local, consulte CM_Get_Child.

Requisitos

   
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_Parent_Ex