_get_tzname

Article
03/04/2013

Extrait la représentation de chaîne de caractères du nom du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician).

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

Paramètres

[out] pReturnValue
La longueur de chaîne d' timeZoneName y compris une marque de fin null.
[out] timeZoneName
L'adresse d'une chaîne de caractères pour la représentation du nom du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician), selon index.
[in] sizeInBytes
la taille de la chaîne de caractères d' timeZoneName en octets.
[in] index
L'index de l'un des deux noms de fuseau horaire à récupérer.

Valeur de retour

Zéro si l'opération a réussi, sinon une valeur de type d' errno .

Si ou timeZoneName est NULL, ou sizeInBytes est zéro ou inférieur à zéro (mais pas les deux), un gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, les ensembles errno de cette fonction à EINVAL et retourne EINVAL.

conditions d'erreur

pReturnValue	timeZoneName	sizeInBytes	index	Valeur de retour	contenu d' timeZoneName
taille du nom de la t-z	NULL	0	0 ou 1 ;	0	non modifié
taille du nom de la t-z	quels	> 0	0 ou 1 ;	0	La t-z nom
non modifié	NULL	> 0	quels	EINVAL	non modifié
non modifié	quels	zéro	quels	EINVAL	non modifié
non modifié	quels	> 0	> 1	EINVAL	non modifié

Notes

La fonction d' _get_tzname récupère la représentation de chaîne de caractères du nom du fuseau horaire ou le nom du fuseau horaire standard de lumière du jour (Desktop prise en charge Technician) dans l'adresse d' timeZoneName selon la valeur d'index, ainsi que la taille de la chaîne dans pReturnValue.Si timeZoneName est NULL et sizeInBytes est zéro, juste la taille de la chaîne de fuseau horaire en octets est retournée dans pReturnValue.Les valeurs d'index doivent être 0 pour le fuseau horaire standard ou 1 pour le fuseau horaire standard de lumière du jour ; toutes les autres valeurs d'index ont des résultats indéterminés.

valeurs d'index

index	contenu d' timeZoneName	valeur par défaut d'timeZoneName
0	nom du fuseau horaire	« PST »
1	Nom du fuseau horaire standard de lumière du jour	« PDT »
> 1 ou < 0	errno défini à EINVAL	non modifié

À moins que les valeurs sont explicitement modifiées au moment de l'exécution, les valeurs par défaut sont « PST » et « PDT » respectivement.les tailles de ces tableaux de caractères sont régies par valeur d' TZNAME_MAX .