Función SetupDiGetDeviceInfoListDetailA (setupapi.h)

  • Artículo

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 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, vea la siguiente sección Comentarios .

Valor devuelto

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

Comentarios

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 a 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, se debe usar al llamar a CM_Xxx_Ex funciones 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 Convenciones para prototipos de función.

Requisitos

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

Consulte también

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass