função CM_Locate_DevNode_ExA (cfgmgr32.h)
[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Locate_DevNode .]
A função CM_Locate_DevNode_Ex obtém um identificador de instância de dispositivo para o nó do dispositivo associado a uma ID de instância de dispositivo especificada, em um computador local ou em um computador remoto.
Sintaxe
CMAPI CONFIGRET CM_Locate_DevNode_ExA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parâmetros
[out] pdnDevInst
[in, optional] pDeviceID
[in] ulFlags
Uma variável do tipo ULONG que fornece um dos seguintes valores de sinalizador que se aplicam se o chamador fornecer um identificador de instância do dispositivo:
CM_LOCATE_DEVNODE_NORMAL
A função recupera o identificador da instância do dispositivo para o dispositivo especificado somente se o dispositivo estiver configurado atualmente na árvore de dispositivos.
CM_LOCATE_DEVNODE_PHANTOM
A função recupera um identificador de instância de dispositivo para o dispositivo especificado se o dispositivo estiver configurado atualmente na árvore do dispositivo ou se o dispositivo for um dispositivo não representado que não esteja configurado atualmente na árvore de dispositivos.
CM_LOCATE_DEVNODE_CANCELREMOVE
A função recupera um identificador de instância de dispositivo para o dispositivo especificado se o dispositivo estiver configurado atualmente na árvore do dispositivo ou no processo de ser removido para a árvore de dispositivos. Se o dispositivo estiver em processo de remoção, a função cancelará a remoção do dispositivo.
CM_LOCATE_DEVNODE_NOVALIDATION
Não usado.
[in, optional] hMachine
Um identificador de computador obtido de uma chamada para CM_Connect_Machine ou um identificador de computador ao qual um conjunto de informações do dispositivo está associado. O identificador do computador para um conjunto de informações do dispositivo é obtido do membro RemoteMachineHandle da estrutura SP_DEVINFO_LIST_DETAIL_DATA para o conjunto de informações do dispositivo. Chame SetupDiGetDeviceInfoListDetail para obter uma estrutura SP_DEVINFO_LIST_DETAIL_DATA.
Retornar valor
Se a operação for bem-sucedida, CM_Locate_DevNode retornará CR_SUCCESS. Caso contrário, a função 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 a um computador local ou remoto, consulte CM_Get_Child_Ex.
A funcionalidade para acessar computadores remotos foi removida em sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.
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 |