_get_tzname

Artigo
08/25/2010

Recupera a representação de seqüência de caractere do fuso horário nome ou o horário de verão padrão fuso horário nome (DST).

errno_t _get_tzname(
    size_t* pReturnValue,
    char* timeZoneName,
    size_t sizeInBytes,
    int index    
);

Parâmetros

[out] pReturnValue
O comprimento da seqüência de caracteres de timeZoneName incluindo um terminador nulo.
[out] timeZoneName
O endereço de uma seqüência de caractere para a representação do fuso horário nome ou o horário de verão padrão fuso horário nome (DST), dependendo do index.
[in]sizeInBytes
O dimensionar do timeZoneName seqüência de caractere em bytes.
[in]index
O índice de uma das duas fuso horário nomes para recuperar.

Valor de retorno

Zero se for bem-sucedido, caso contrário, um errno Digite o valor.

Se qualquer um dos timeZoneName é NULL, ou sizeInBytes é zero ou menor que zero (mas não ambos), um manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essa função define errno para EINVAL e retornos EINVAL.

Condições de erro

pReturnValue	timeZoneName	sizeInBytes	index	Valor de Retorno	Contents of timeZoneName
dimensionar de nome TZ	NULL	0	0 ou 1	0	não modificado
dimensionar de nome TZ	any	> 0	0 ou 1	0	Nome TZ
não modificado	NULL	> 0	any	EINVAL	não modificado
não modificado	any	zero	any	EINVAL	não modificado
não modificado	any	> 0	> 1	EINVAL	não modificado

Comentários

The _get_tzname função recupera a representação de seqüência de caractere do fuso horário nome ou o horário de verão padrão fuso horário (DST) de nome para o endereço do timeZoneName Dependendo do valor de índice, juntamente com o dimensionar da seqüência de caractere da pReturnValue. If timeZoneName é NULL e sizeInBytes é igual a zero, o dimensionar da seqüência de caracteres de um fuso horário em bytes é retornado em pReturnValue. Os valores de índice devem ser 0 para padrão fuso horário ou 1 para o horário de verão padrão fuso horário; quaisquer outros valores de índice têm resultados indeterminados.

Valores de índice

index	Contents of timeZoneName	timeZoneName valor padrão
0	Nome de fuso horário	"PST"
1	Nome de zona de time padrão verão	"PDT"
>1 ou 0 <	errno definido como EINVAL	não modificado

A menos que explicitamente os valores sejam alterados durante o time de execução, os valores padrão são "PST" e "PDT" respectivamente.Os tamanhos desses conjuntos de caractere são regidos por TZNAME_MAX valor.