Función wvsprintfA (winuser.h)
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.
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 |
Consulte también
Conceptual
Referencia