función CM_Get_Device_ID_Size (cfgmgr32.h)
La función CM_Get_Device_ID_Size recupera el tamaño del búfer necesario para contener un identificador de instancia de dispositivo para una instancia de dispositivo en el equipo local.
Nota
En Windows Vista y versiones posteriores de Windows, el modelo de propiedad 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_ID_Size(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parámetros
[out] pulLen
Recibe un valor que representa el tamaño de búfer necesario, en caracteres.
[in] dnDevInst
Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.
[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 CR_ prefijo definidos en Cfgmgr32.h.
Comentarios
Se debe llamar a la función CM_Get_Device_ID_Size para determinar el tamaño del búfer requerido por CM_Get_Device_ID.
El valor de tamaño proporcionado en la ubicación a la que apunta pulLen es menor que MAX_DEVICE_ID_LEN y no incluye el valor NULL de terminación de la cadena de identificador. Si la instancia de dispositivo especificada no existe, la función proporciona un valor de tamaño de cero.
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 la máquina 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; OneCoreUAP.lib en Windows 10 |
| Archivo DLL | CfgMgr32.dll |