_strdate_s, _wstrdate_s

Artículo
04/10/2013

Copie la fecha actual del sistema a un búfer.Éstas son versiones de _strdate, _wstrdate con mejoras de seguridad como se describe en Características de seguridad en CRT.

errno_t _strdate_s(
   char *buffer,
   size_t numberOfElements
);
errno_t _wstrdate_s(
   wchar_t *buffer,
   size_t numberOfElements
);
template <size_t size>
errno_t _strdate_s(
   char (&buffer)[size]
); // C++ only
template <size_t size>
errno_t _wstrdate_s(
   wchar_t (&buffer)[size]
); // C++ only

Parámetros

[out] buffer
Un puntero a un búfer que se completará con la cadena de fecha con formato.
[in] numberOfElements
Tamaño del búfer.

Valor devuelto

cero si correctamente.el valor devuelto es un código de error si hay un error.Los códigos de error se definen en ERRNO.H; vea la tabla siguiente para los errores exactos generados por esta función.Para obtener más información sobre los códigos de error, vea errno.

condiciones de error

buffer	numberOfElements	Return	Contenido de buffer
NULL	(ninguno)	EINVAL	no modificado
No NULL (del búfer válido)	0	EINVAL	no modificado
No NULL (del búfer válido)	0 < numberOfElements < 9	EINVAL	Cadena vacía
No NULL (del búfer válido)	numberOfElements >= 9	0	Fecha actual con formato como se especifica en las notas

problemas de seguridad

El paso de no un valor no válido de NULL para el búfer producirá una infracción de acceso si el parámetro de numberOfElements es mayor que 9.

Pasar valores para el tamaño que es mayor que el tamaño real de buffer dará lugar a la saturación del búfer.

Comentarios

estas funciones proporcionan versiones más seguras de _strdate y de _wstrdate.La función de _strdate_s copia la fecha actual del sistema en el búfer indicada por buffer, mmcon formato/dd/yy, donde dos dígitos mm que representan el mes, dd es dos dígitos que representan el día, y yy es los dos últimos dígitos del año.por ejemplo, la cadena 12/05/99 representa el 5 de diciembre de 1999.El búfer debe ser por lo menos de 9 caracteres.

_wstrdate_s es una versión con caracteres anchos de _strdate_s; el argumento y el valor devuelto de _wstrdate_s son cadenas de caracteres.Estas funciones se comportan exactamente igual de otra manera.

Si buffer es un puntero de NULL , o si numberOfElements es menos de 9 caracteres, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, estas funciones devuelven -1 y errno establecido en EINVAL si el búfer es NULL o si numberOfElements es menor o igual que 0, o conjunto errno a ERANGE si es numberOfElements menos de 9.

En C++, mediante estas funciones es simplificado con sobrecargas de plantilla; las sobrecargas pueden deducir la longitud de búfer automáticamente (que elimina la necesidad de especificar un argumento de tamaño) y automáticamente pueden reemplazar anterior, funciones de no con sus más recientes, seguros homólogos.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignación rutinaria de texto genérico: