función CM_Get_Parent (cfgmgr32.h)

La función CM_Get_Parent obtiene un identificador de instancia de dispositivo para el nodo primario de un nodo de dispositivo especificado (devnode) en el árbol de dispositivos del equipo local.

Nota

En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado usa la clave de propiedadDEVPKEY_Device_Parent para representar el elemento primario del dispositivo. Consulte Recuperación de relaciones de dispositivos para obtener más información.

Sintaxis

CMAPI CONFIGRET CM_Get_Parent(
  [out] PDEVINST pdnDevInst,
  [in]  DEVINST  dnDevInst,
  [in]  ULONG    ulFlags
);

Parámetros

[out] pdnDevInst

Puntero proporcionado por el autor de la llamada al identificador de la instancia del dispositivo al nodo primario que recupera esta función. El identificador recuperado está enlazado al equipo local.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] ulFlags

No se usa, debe ser cero.

Valor devuelto

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

Comentarios

Para obtener información sobre el uso de un identificador de instancia de dispositivo enlazado al equipo local, consulte CM_Get_Child.

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; OneCoreUAP.lib en Windows 10
Archivo DLL CfgMgr32.dll

Consulte también

CM_Get_Child

CM_Get_Parent_Ex