_strtime_s, _wstrtime_s

Artigo
08/25/2010

A time corrente para um buffer de cópia.Essas são sistema autônomo versões de _strtime, _wstrtime com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

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

Parâmetros

[out] buffer
Um buffer de, pelo menos 10 bytes long, em que a time será gravada.
[in]numberOfElements
O dimensionar do buffer.

Valor de retorno

Zero se for bem-sucedido.

Se ocorrer uma condição de erro, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. 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 a seguir para as exatas erros gerados por essa função.Para obter mais informações sobre códigos de erro, consulte Constantes errno.

Condições de erro

buffer	numberOfElements	Return	Sumário de 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 < dimensionar < 9	EINVAL	Seqüência de caracteres vazia
Not NULL (apontando para o buffer válido)	Dimensionar > 9	0	time corrente formatada sistema autônomo especificado nos comentários

Questões de segurança

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

Passando um valor de numberOfElements é maior do que o dimensionar do buffer real resultará na saturação de buffer.

Comentários

Essas funções fornecem versões mais seguras de _strtime e _wstrtime. The _strtime_s função copia a time local corrente para o buffer apontado por timestr*.* O time é formatado sistema autônomo hh:mm:ss onde hh é dois dígitos que representa a time em notação de 24 horas, mm é de dois dígitos que representa sistema autônomo minutos depois da time estabelecida, e ss é dois dígitos representando segundos. Por exemplo, a seqüência de caracteres 18:23:44 representa 23 minutos e 44 segundos após 6 horas O buffer deve ser pelo menos 9 bytes; o dimensionar real é especificado pelo segundo parâmetro.

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

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.For more information, see Proteger overloads de modelo.

Mapeamento de rotina texto genérico:

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tstrtime_s	_strtime_s	_strtime_s	_wstrtime_s

Requisitos

Rotina	Cabeçalho necessário
_strtime_s	<time.h>
_wstrtime_s	<time.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// strtime_s.c

#include <time.h>
#include <stdio.h>

int main()
{
    char tmpbuf[9];
    errno_t err;

    // Set time zone from TZ environment variable. If TZ is not set,
    // the operating system is queried to obtain the default value 
    // for the variable. 
    //
    _tzset();

    // Display operating system-style date and time. 
    err = _strtime_s( tmpbuf, 9 );
    if (err)
    {
       printf("_strdate_s failed due to an invalid argument.");
      exit(1);
    }
    printf( "OS time:\t\t\t\t%s\n", tmpbuf );
    err = _strdate_s( tmpbuf, 9 );
    if (err)
    {
       printf("_strdate_s failed due to an invalid argument.");
       exit(1);
    }
    printf( "OS date:\t\t\t\t%s\n", tmpbuf );

}

OS time:            14:37:49 OS date:            04/25/03