_strdate_s, _wstrdate_s

Artigo
08/25/2010

A data corrente do sistema para um buffer de cópia.Essas são sistema autônomo versões de _strdate, _wstrdate com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no 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
Um ponteiro para um buffer que irá ser preenchido com a seqüência de caracteres de data formatada.
[in]numberOfElements
dimensionar do buffer.

Valor de retorno

Zero se for bem-sucedido.O valor retornado é um código de erro se houver uma falha.Códigos de erro são definidos no ERRNO.H; consulte a tabela abaixo para os exatas erros gerados por essa função.Para obter mais informações sobre códigos de erro, consulte errno.

Condições de erro

buffer	numberOfElements	Return	Contents of buffer
NULL	(qualquer)	EINVAL	Não modificado
Not NULL (apontando para o buffer válido)	0	EINVAL	Não modificado
Not NULL (apontando para o buffer válido)	0 < numberOfElements < 9	EINVAL	Seqüência de caracteres vazia
Not NULL (apontando para o buffer válido)	numberOfElements >= 9	0	Data corrente formatada sistema autônomo especificado nos comentários

Questões de segurança

Passando um não inválido NULL valor para o buffer resultará em uma violação de acesso se a numberOfElements parâmetro é maior que 9.

Passar valores para o dimensionar que é maior do que o dimensionar real do buffer resultará na saturação de buffer.

Comentários

Essas funções fornecem versões mais seguras de _strdate e _wstrdate. The _strdate_s função copia a data corrente do sistema para o buffer apontado por buffer, formatado mm/dd/yy, onde mm é dois dígitos que representa o mês dd é de dois dígitos que representa o dia e yy é os dois últimos dígitos do ano. Por exemplo, a seqüência de caracteres 12/05/99 representa 5 de dezembro de 1999. O buffer deve ser pelo menos 9 bytes.

_wstrdate_s é uma versão de caractere largo da _strdate_s; valor de argumento e retornar _wstrdate_s são seqüências de caracteres largos. Essas funções se comportam exatamente caso contrário.

If buffer é um NULL ponteiro, ou se numberOfElements é menor do que 9 caracteres, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam -1 e definir errno para EINVAL Se o buffer é NULL ou se numberOfElements é menor ou igual a 0 ou conjunto errno para ERANGE Se numberOfElements é menor do que 9.

No C++, usando essas funções é simplificado pelo modelo sobrecargas; sobrecargas de podem inferir o comprimento do buffer automaticamente (eliminando a necessidade de especificar um argumento de dimensionar) e eles podem substituir automaticamente funções não seguras, mais antigas, com suas contrapartes mais recentes e seguras.Para obter mais informações, consulte Proteger overloads de modelo.

Mapeamento de rotina texto genérico: