Função CM_Get_Sibling (cfgmgr32.h)

  • Artigo

A função CM_Get_Sibling obtém um identificador de instância de dispositivo para o próximo nó irmão 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_Siblings para representar irmãos do dispositivo. Consulte Recuperando relações de dispositivo para obter detalhes.

Sintaxe

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

Parâmetros

[out] pdnDevInst

Ponteiro fornecido pelo chamador para o identificador de instância do dispositivo para o nó irmão 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.

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 enumerar todos os filhos de um devnode na árvore de dispositivos do computador local, primeiro chame CM_Get_Child para obter um identificador para o primeiro nó filho e, em seguida, chame CM_Get_Sibling para obter identificadores para o restante dos filhos.

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_Sibling_Ex