função CM_Get_Child_Ex (cfgmgr32.h)
[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Child .]
A função CM_Get_Child_Ex é usada para recuperar um identificador de instância de dispositivo para o primeiro nó filho de um nó de dispositivo especificado (devnode) em uma árvore de dispositivos local ou de um computador remoto.
Sintaxe
CMAPI CONFIGRET CM_Get_Child_Ex(
[out] PDEVINST pdnDevInst,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parâmetros
[out] pdnDevInst
Ponteiro fornecido pelo chamador para o identificador da instância do dispositivo para o nó filho que essa função recupera. O identificador recuperado está associado ao identificador do computador fornecido pelo hMachine. Consulte a seção Comentários .
[in] dnDevInst
Identificador de instância de dispositivo fornecido pelo chamador associado ao identificador do computador fornecido pelo hMachine.
[in] ulFlags
Não usado, deve ser zero.
[in, optional] hMachine
Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.
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 em uma árvore de dispositivos local ou de um computador remoto, primeiro chame CM_Get_Child_Ex para obter um identificador para o primeiro nó filho e, em seguida, chame CM_Get_Sibling_Ex para obter identificadores para o resto dos filhos.
Usando identificadores de instância de dispositivo
O identificador de instância do dispositivo que você usa com funções do Gerenciador de Configurações PnP está associado a identificadores de computador, da seguinte maneira:
- Todos os identificadores de instância de dispositivo local estão associados a um identificador de computador local com valor NULL.
- Se você usar um identificador de computador remoto para obter um identificador de instância do dispositivo, o identificador de instância de dispositivo remoto resultante será associado ao identificador do computador remoto.
- Um identificador de instância do dispositivo só pode ser usado com o identificador do computador ao qual está associado.
- Um identificador de instância do dispositivo só poderá ser usado com outro identificador de instância de dispositivo se ambos os identificadores de instância do dispositivo estiverem associados ao mesmo identificador de computador.
Para obter um identificador de instância de dispositivo local ou remoto, siga um destes procedimentos.
- Use uma das seguintes funções para recuperar um identificador de instância de dispositivo associado ao computador local: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent ou CM_Get_Sibling.
- Use uma das seguintes funções para recuperar um identificador de instância de dispositivo associado a um computador local ou remoto: CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex ou CM_Get_Sibling_Ex.
- Obter um conjunto de informações do dispositivo.
- Obtenha uma estrutura de SP_DEVINFO_DATA para uma instância de dispositivo no conjunto de informações do dispositivo.
- Obtenha o identificador de instância do dispositivo para a instância do dispositivo do membro DevInst da estrutura SP_DEVINFO_DATA.
- Obtenha o identificador do computador ao qual o identificador da instância do dispositivo está associado. Um identificador de instância de dispositivo obtido de um conjunto de informações do dispositivo está associado ao identificador do computador ao qual o conjunto de informações do dispositivo está associado. Você obtém o identificador do computador para um conjunto de informações de dispositivo do membro RemoteMachineHandle de sua estrutura SP_DEVINFO_LIST_DETAIL_DATA . (Chame SetupDiGetDeviceInfoListDetail para obter uma estrutura SP_DEVINFO_LIST_DETAIL_DATA.)
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
Biblioteca | Cfgmgr32.lib |
DLL | Cfgmgr32.dll |