función CM_Locate_DevNodeW (cfgmgr32.h)
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_DevNodeW(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_W 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 de dispositivos de .
[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 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 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 de CR_Xxx definidos en cfgmgr32.h.
Observaciones
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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Universal |
| encabezado de |
cfgmgr32.h (incluya Cfgmgr32.h) |
| biblioteca de |
Cfgmgr32.lib |
| DLL de |
CfgMgr32.dll |