Función wvsprintfA (winuser.h)

Artículo
03/15/2023

Escribe datos con formato en el búfer especificado mediante un puntero a una lista de argumentos. Los elementos a los que apunta la lista de argumentos se convierten y copian en un búfer de salida según la especificación de formato correspondiente en la cadena de control de formato. La función anexa un carácter nulo de terminación a los caracteres que escribe, pero el valor devuelto no incluye el carácter nulo de terminación en su recuento de caracteres.

Advertencia No use. Considere la posibilidad de usar una de las siguientes funciones en su lugar: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintf o StringCchVPrintfEx. Consulte Consideraciones de seguridad.

Sintaxis

int wvsprintfA(
  [out] LPSTR   unnamedParam1,
  [in]  LPCSTR  unnamedParam2,
  [in]  va_list arglist
);

Parámetros

[out] unnamedParam1

Tipo: LPTSTR

Búfer que va a recibir la salida con formato. El tamaño máximo del búfer es de 1024 bytes.

[in] unnamedParam2

Tipo: LPCTSTR

Las especificaciones de control de formato. Además de los caracteres ASCII normales, aparece una especificación de formato para cada argumento en esta cadena. Para obtener más información sobre la especificación de formato, vea la función wsprintf .

[in] arglist

Tipo: va_list

Cada elemento de esta lista especifica un argumento para la cadena de control de formato. El número, el tipo y la interpretación de los argumentos dependen de las especificaciones de control de formato correspondientes en el parámetro lpFmt .

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, el valor devuelto es el número de caracteres almacenados en el búfer, sin contar el carácter nulo de terminación.

Si se produce un error en la función, el valor devuelto es menor que la longitud de la salida esperada. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función copia la cadena de control de formato en el carácter de búfer de salida por carácter, empezando por el primer carácter de la cadena. Cuando encuentra una especificación de formato en la cadena, la función recupera el valor del siguiente argumento disponible (empezando por el primer argumento de la lista), convierte ese valor en el formato especificado y copia el resultado en el búfer de salida. La función continúa copiando caracteres y expandiendo las especificaciones de formato de esta manera hasta que llega al final de la cadena de control de formato. Si hay más argumentos que las especificaciones de formato, se omiten los argumentos adicionales. Si no hay suficientes argumentos para todas las especificaciones de formato, los resultados no están definidos.

Nota

El encabezado winuser.h define wvsprintf 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll