función CM_Get_Device_IDA (cfgmgr32.h)

  • Artículo

La función CM_Get_Device_ID recupera el identificador de instancia de dispositivo de una instancia de dispositivo especificada en el equipo local.

Nota

En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado usa la clave de propiedadDEVPKEY_Device_InstanceId para representar el identificador de instancia del dispositivo. Consulte Recuperación de un identificador de instancia de dispositivo para obtener más información.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_IDA(
  [in]  DEVINST dnDevInst,
  [out] PSTR    Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parámetros

[in] dnDevInst

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

[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 y, a continuación, incrementando el valor recibido para permitir espacio para la terminación NULL de la cadena.

[in] BufferLen

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

[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

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 la mayor parte de la cadena de identificador que 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 al equipo local, consulte CM_Get_Child.

Requisitos

Requisito Value
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

Consulte también

CM_Get_Child
CM_Get_Device_ID_Ex