Função CM_Locate_DevNode_ExW (cfgmgr32.h)
[A partir do Windows 8 e do 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_ExW(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_W pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parâmetros
[out] pdnDevInst
Um ponteiro para o identificador de instância do dispositivo que essa função recupera. O identificador recuperado está associado ao identificador do computador especificado por hMachine.
[in, optional] pDeviceID
Um ponteiro para uma cadeia de caracteres terminada em NULL que representa uma ID de instância do dispositivo. Se esse valor for NULL ou se ele apontar para uma cadeia de caracteres de comprimento zero, a função fornecerá um identificador de instância de dispositivo para o dispositivo na raiz da árvore de dispositivos.
[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 de dispositivo:
CM_LOCATE_DEVNODE_NORMAL
A função recupera o identificador de 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 recuperará um identificador de instância de dispositivo para o dispositivo especificado se o dispositivo estiver configurado atualmente na árvore de dispositivos 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 recuperará um identificador de instância de dispositivo para o dispositivo especificado se o dispositivo estiver configurado atualmente na árvore de dispositivos 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.
Valor retornado
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 nos 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
| 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 |