función CM_Get_Device_ID_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 en su lugar.]

La función CM_Get_Device_ID_Ex recupera el identificador de instancia de dispositivo para una instancia de dispositivo especificada en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_ID_ExA(
  [in]           DEVINST  dnDevInst,
  [out]          PSTR     Buffer,
  [in]           ULONG    BufferLen,
                 ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada enlazado al identificador de la máquina proporcionado por hMachine.

[out] Buffer

Dirección de un búfer para recibir una cadena de identificador de instancia de dispositivo. El tamaño de búfer necesario se puede obtener llamando a CM_Get_Device_ID_Size_Ex y, a continuación, incrementando el valor recibido para permitir espacio para el valor NULL de terminación de la cadena.

[in] BufferLen

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

ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

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

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 CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

La función anexa un terminador NULL a la cadena de identificador de instancia de dispositivo proporcionada, a menos que el búfer sea demasiado pequeño para contener la cadena. En este caso, la función proporciona tanta cadena de identificador como caberá en el búfer y, a continuación, devuelve CR_BUFFER_SMALL.

Para obtener información sobre los identificadores de instancia de dispositivo, consulte Cadenas de identificación de dispositivos.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos 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

Consulte también

CM_Get_Child_Ex
CM_Get_Device_ID