_get_tzname

Articolo
03/05/2013

Recupera la rappresentazione di stringa di caratteri del nome del fuso orario o il nome dell'area di ora solare di legale (DST).

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

Parametri

[out] pReturnValue
La lunghezza della stringa di timeZoneName incluso un carattere di terminazione null.
[out] timeZoneName
L'indirizzo di una stringa di caratteri per la rappresentazione del nome del fuso orario o il nome dell'area di ora solare di legale (DST), come index.
[in] sizeInBytes
La dimensione di timeZoneName stringa di caratteri in byte.
[in] index
L'indice di uno dei due nomi del fuso orario da recuperare.

Valore restituito

Zero se l'operazione viene completata correttamente, altrimenti errno valore di tipo.

Se uno timeZoneName viene NULL, o sizeInBytes è zero o minore di zero (ma non entrambi), un gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, set di questa funzione errno in EINVAL e restituisce EINVAL.

condizioni di errore

pReturnValue	timeZoneName	sizeInBytes	index	Valore restituito	Contenuto di timeZoneName
dimensione del nome della t-z	NULL	0	0 o 1	0	non modificato
dimensione del nome della t-z	qualsiasi	> 0	0 o 1	0	La t-z denominazione
non modificato	NULL	> 0	qualsiasi	EINVAL	non modificato
non modificato	qualsiasi	zero	qualsiasi	EINVAL	non modificato
non modificato	qualsiasi	> 0	> 1	EINVAL	non modificato

Note

_get_tzname la funzione recupera la rappresentazione di stringa di caratteri del nome del fuso orario o il nome dell'area di ora solare di legale (DST) l'indirizzo di timeZoneName a seconda del valore di indice, con la dimensione delle stringhe in pReturnValue.se timeZoneName viene NULL e sizeInBytes è zero, solo la dimensione di una serie di qualsiasi fuso orario in byte viene restituita in pReturnValue.I valori di indice devono essere 0 per l'area di ora standard o 1 per l'area di ora solare di legale, tutti gli altri valori di indice hanno risultati imprevisti.

valori di indice

index	Contenuto di timeZoneName	timeZoneName valore predefinito
0	Nome del fuso orario	“PST„
1	Nome dell'area di ora solare di legale	“PDT„
> 1 o < 0	errno impostare su EINVAL	non modificato

A meno che i valori in modo esplicito vengano modificati durante la fase di esecuzione, i valori predefiniti sono rispettivamente “PST„ e “PDT„.Le dimensioni delle matrici di caratteri dipendono da TZNAME_MAX valore.