Compartilhar via


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.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

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

Confira também

CM_Get_Child_Ex
CM_Locate_DevNode