función CM_Get_Device_ID_Size_Ex (cfgmgr32.h)
[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Get_Device_ID_Size en su lugar.]
La función CM_Get_Device_ID_Size_Ex recupera el tamaño del búfer necesario para contener un identificador de instancia de dispositivo para una instancia de dispositivo en un equipo local o remoto.
Sintaxis
CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
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.
[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.
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_Ex para determinar el tamaño del búfer requerido por CM_Get_Device_ID_Ex.
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 un equipo local o remoto, consulte CM_Get_Child_Ex.
La funcionalidad para acceder a las máquinas remotas se ha quitado en los sistemas operativos Windows 8 y 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
| 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 |
| Archivo DLL | Cfgmgr32.dll |