Función SetupDiGetDeviceInfoListDetailA (setupapi.h)

La función SetupDiGetDeviceInfoListDetail recupera información asociada a un conjunto de información del dispositivo, incluido el GUID de clase, el identificador de equipo remoto y el nombre del equipo remoto.

Sintaxis

WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
  [in]  HDEVINFO                       DeviceInfoSet,
  [out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo para el que se va a recuperar información.

[out] DeviceInfoSetDetailData

Puntero a una estructura de SP_DEVINFO_LIST_DETAIL_DATA inicializada por el autor de la llamada que recibe la información del conjunto de información del dispositivo. Para obtener más información sobre esta estructura, consulte la siguiente sección Comentarios.

Valor devuelto

La función devuelve TRUE si se ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError.

Observaciones

Si los parámetros son válidos, SetupDiGetDeviceInfoListDetail establece valores en la estructura DeviceInfoSetDetailData (excepto el campo cbSize) y devuelve el estado NO_ERROR.

Un autor de llamada de setupDiGetDeviceInfoListDetail debe establecer DeviceInfoSetDetailData. cbSize para sizeof(SP_DEVINFO_LIST_DETAIL_DATA) o la función producirá un error y la llamada a GetLastError devolverá ERROR_INVALID_USER_BUFFER.

Si setupDiGetDeviceInfoListDetail se completa correctamente, DeviceInfoSetDetailData.ClassGuid contiene el GUID de clase asociado al conjunto de información del dispositivo o una estructura de GUID_NULL.

Si setupDiGetDeviceInfoListDetail se completa correctamente y el conjunto de información del dispositivo es para un sistema remoto, DeviceInfoSetDetailData.remoteMachineHandle contiene el identificador del sistema ConfigMgr32 para acceder al sistema remoto y DeviceInfoSetDetailData.RemoteMachineName contiene el nombre del sistema remoto. Si hay un identificador remoto para el conjunto de información del dispositivo, debe usarse al llamar a CM_funciones xxx_Ex porque los identificadores de DevInst son relativos al identificador remoto.

Si el conjunto de información del dispositivo es para el equipo local, DeviceInfoSetDetailData. RemoteMachineHandle es NULL y DeviceInfoSetDetailData.remoteMachineName es una cadena vacía.

Nota

El encabezado setupapi.h define SetupDiGetDeviceInfoListDetail 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	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

setupDiGetDeviceInfoListClass