função CM_Locate_DevNodeA (cfgmgr32.h)
A função CM_Locate_DevNode obtém um identificador de instância do dispositivo para o nó do dispositivo associado a uma ID de instância de dispositivo especificada no computador local.
Sintaxe
CMAPI CONFIGRET CM_Locate_DevNodeA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags
);
Parâmetros
[out] pdnDevInst
Um ponteiro para um identificador de instância de dispositivo que CM_Locate_DevNode recupera. O identificador recuperado está associado ao computador local.
[in, optional] pDeviceID
Um ponteiro para uma cadeia de caracteres terminada em NULL que representa uma ID da instância do dispositivo . Se esse valor for NULL ou se apontar para uma cadeia de caracteres de comprimento zero, a função recuperará um identificador de instância de dispositivo para o dispositivo na raiz da árvore de dispositivo .
[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 da instância do dispositivo para o dispositivo especificado somente se o dispositivo estiver configurado na árvore do dispositivo.
CM_LOCATE_DEVNODE_PHANTOM
A função recupera um identificador de instância do dispositivo para o dispositivo especificado se o dispositivo estiver configurado atualmente na árvore do dispositivo ou se o dispositivo for um dispositivo dispositivo não representado que não está configurado atualmente na árvore do dispositivo.
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 da árvore do dispositivo. 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.
Valor de retorno
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 CR_Xxx definidos em Cfgmgr32.h.
Observações
Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.
Nota
O cabeçalho cfgmgr32.h define CM_Locate_DevNode como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| da Plataforma de Destino |
Universal |
| cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
| biblioteca | Cfgmgr32.lib |
| de DLL |
CfgMgr32.dll |