Função CM_Locate_DevNodeW (cfgmgr32.h)

  • Artigo

A função CM_Locate_DevNode obtém um identificador de instância de dispositivo para o nó do dispositivo associado a uma ID de instância de dispositivo especificada no computador local.

Sintaxe

CMAPI CONFIGRET CM_Locate_DevNodeW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W 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 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 recuperará 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 recupera 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 da á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.

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 CR_Xxx definidos em Cfgmgr32.h.

Comentários

Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL CfgMgr32.dll

Confira também

CM_Get_Child

CM_Locate_DevNode_Ex