CM_Locate_DevNode_ExW función (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Locate_DevNode en su lugar.

La función CM_Locate_DevNode_Ex obtiene un identificador de instancia de dispositivo para el nodo de dispositivo asociado a un identificador de instancia de dispositivo especificado, en un equipo local o en un equipo remoto.

Sintaxis

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

Puntero al identificador de la instancia de dispositivo que recupera esta función. El identificador recuperado está enlazado al identificador de equipo especificado por hMachine.

[in, optional] pDeviceID

Puntero a una cadena terminada en NULL que representa un identificador de instancia de dispositivo. Si este valor es NULL o apunta a una cadena de longitud cero, la función proporciona un identificador de instancia de dispositivo al dispositivo en la raíz del árbol del dispositivo.

[in] ulFlags

Variable de tipo ULONG que proporciona uno de los siguientes valores de marca que se aplican si el autor de la llamada proporciona un identificador de instancia de dispositivo:

CM_LOCATE_DEVNODE_NORMAL

La función recupera el identificador de instancia del dispositivo para el dispositivo especificado solo si el dispositivo está configurado actualmente en el árbol de dispositivos.

CM_LOCATE_DEVNODE_PHANTOM

La función recupera un identificador de instancia de dispositivo para el dispositivo especificado si el dispositivo está configurado actualmente en el árbol de dispositivos o el dispositivo es un dispositivo no representativo que no está configurado actualmente en el árbol de dispositivos.

CM_LOCATE_DEVNODE_CANCELREMOVE

La función recupera un identificador de instancia de dispositivo para el dispositivo especificado si el dispositivo está configurado actualmente en el árbol de dispositivos o en el proceso de quitarse para el árbol de dispositivos. Si el dispositivo está en proceso de eliminación, la función cancela la eliminación del dispositivo.

CM_LOCATE_DEVNODE_NOVALIDATION

No se usa.

[in, optional] hMachine

Identificador de máquina obtenido de una llamada a CM_Connect_Machine o un identificador de máquina al que está enlazado un conjunto de información del dispositivo. El identificador de equipo de un conjunto de información del dispositivo se obtiene del miembro RemoteMachineHandle de la estructura SP_DEVINFO_LIST_DETAIL_DATA del conjunto de información del dispositivo. Llame a SetupDiGetDeviceInfoListDetail para obtener una estructura SP_DEVINFO_LIST_DETAIL_DATA.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

Valor devuelto

Si la operación se realiza correctamente, CM_Locate_DevNode devuelve CR_SUCCESS. De lo contrario, la función devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

   
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib

Consulte también

CM_Get_Child_Ex

CM_Locate_DevNode