_get_tzname

Articolo
06/09/2015

Recupera la rappresentazione di stringa di caratteri del nome del fuso orario o il nome dell'ora solare 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 includendo 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'ora solare di legale (DST), dipendente da index.
[in] sizeInBytes
Dimensione della stringa di caratteri timeZoneName 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 un valore di tipo errno.

Se o timeZoneName è NULL, o sizeInBytes è zero o minore di zero (ma non entrambi), un gestore di parametro non valido viene richiamato, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno e imposta EINVAL su EINVAL.

Condizioni di errore

pReturnValue	timeZoneName	sizeInBytes	index	Valore restituito	Contenuto di timeZoneName.
dimensione del nome di TZ	NULL	0	0 o 1	0	non modificato
dimensione del nome di TZ	any	> 0	0 o 1	0	nome di TZ
non modificato	NULL	> 0	any	EINVAL	non modificato
non modificato	any	zero	any	EINVAL	non modificato
non modificato	any	> 0	> 1	EINVAL	non modificato

Note

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

Valori di indice

index	Contenuto di timeZoneName.	Valore predefinito timeZoneName.
0	Nome del fuso orario	"PST"
1	Nome del fuso orario standard.	"PDT"
> 1 o < 0.	errno impostato su EINVAL.	non modificato

A meno che i valori non siano esplicitamente modificati in fase di esecuzione, i valori predefiniti sono rispettivamente "PST" e "PDT". Le dimensioni delle matrici di caratteri dipendono dal valore di TZNAME_MAX.