Compartir a través de

función CM_Get_Device_ID_List_ExA (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Get_Device_ID_List en su lugar.

La función CM_Get_Device_ID_List_Ex recupera una lista de identificadores de instancia de dispositivo para las instancias de dispositivo en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_ID_List_ExA(
  [in, optional] PCSTR    pszFilter,
  [out]          PZZSTR   Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in, optional] pszFilter

Puntero proporcionado por el autor de la llamada a una cadena de caracteres que especifica un subconjunto de identificadores de instancia de dispositivo de la máquina o NULL. Consulte la siguiente descripción de ulFlags.

[out] Buffer

Dirección de un búfer para recibir un conjunto de cadenas de identificador de instancia de dispositivo terminadas en NULL. El final del conjunto finaliza con un valor NULL adicional. El tamaño de búfer necesario debe obtenerse llamando a CM_Get_Device_ID_List_Size_Ex.

[in] BufferLen

Longitud proporcionada por el autor de la llamada, en caracteres, del búfer especificado por Buffer.

[in] ulFlags

Una de las marcas de bits proporcionadas por el autor de la llamada opcionales que especifican filtros de búsqueda. Si no se especifican marcas, la función proporciona todos los identificadores de instancia para todas las instancias de dispositivo. Para obtener una lista de marcas de bits, consulte la descripción de ulFlags para CM_Get_Device_ID_List.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

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 los identificadores de instancia de dispositivo, consulte Cadenas de identificación de dispositivos.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

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