función CM_Get_Device_ID_List_SizeW (cfgmgr32.h)

  • Artículo

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_SizeW(
  [out]          PULONG pulLen,
  [in, optional] PCWSTR 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

CM_Get_Device_ID_List_Size_Ex