función CM_Get_Device_ID_List_SizeA (cfgmgr32.h)
La función CM_Get_Device_ID_List_Size recupera el tamaño del búfer necesario para contener una lista de identificadores de instancia de dispositivo para las instancias de dispositivo de la máquina local.
Sintaxis
CMAPI CONFIGRET CM_Get_Device_ID_List_SizeA(
[out] PULONG pulLen,
[in, optional] PCSTR pszFilter,
[in] ULONG ulFlags
);
Parámetros
[out] pulLen
Recibe un valor que representa el tamaño de búfer necesario, en caracteres.
[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.
[in] ulFlags
Una de las marcas de bits opcionales proporcionadas por el autor de la llamada que especifican filtros de búsqueda. Si no se especifican marcas, la función proporciona el tamaño del búfer necesario para contener todos los identificadores de instancia de 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.
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_List_Size para determinar el tamaño del búfer requerido por CM_Get_Device_ID_List.
Se garantiza que el valor de tamaño proporcionado en la ubicación a la que apunta pulLen representa un tamaño de búfer lo suficientemente grande como para contener todas las cadenas de identificadores de instancia de dispositivo y terminar las NUL. El valor proporcionado podría representar realmente un tamaño de búfer mayor que el necesario, por lo que no suponga que el valor representa la longitud verdadera de las cadenas de caracteres que CM_Get_Device_ID_List proporcionará.
Para obtener información sobre los identificadores de instancia de dispositivo, consulte Cadenas de identificación de dispositivos.
Nota
El encabezado cfgmgr32.h define CM_Get_Device_ID_List_Size como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 |
Archivo DLL | CfgMgr32.dll |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de