Função CM_Get_Sibling (cfgmgr32.h)
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 |