función CM_Locate_DevNodeA (cfgmgr32.h)

  • Artículo

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

Sintaxis

CMAPI CONFIGRET CM_Locate_DevNodeA(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags
);

Parámetros

[out] pdnDevInst

Puntero a un identificador de instancia de dispositivo que CM_Locate_DevNode recupera. El identificador recuperado está enlazado al equipo local.

[in, optional] pDeviceID

Puntero a una cadena terminada en NULL que representa un identificador de instancia de dispositivo. Si este valor es NULL o si apunta a una cadena de longitud cero, la función recupera 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 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 del árbol de dispositivos. Si el dispositivo está en proceso de quitarse, la función cancela la eliminación del dispositivo.

CM_LOCATE_DEVNODE_NOVALIDATION

No se usa.

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

Comentarios

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a la máquina local, consulte CM_Get_Child.

Nota:

El encabezado cfgmgr32.h define CM_Locate_DevNode como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

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

Consulte también

CM_Get_Child

CM_Locate_DevNode_Ex