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

Confira também

CM_Get_Child_Ex

CM_Locate_DevNode