_get_tzname

Artikel
02/26/2013

Ruft die Zeichenfolgen Zeitzonen Darstellung des Namens oder des Namens ab Tageslicht-Normalzeit-Zonen (DST).

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

Parameter

[out] pReturnValue
Die Zeichenfolgenlänge von timeZoneName einschließlich NULL-Abschlusszeichen ein.
[out] timeZoneName
Die Adresse einer Zeichenfolge zur Darstellung des Namens oder des Tageslicht-Normalzeit-Zonen Zeitzonen Namens (DST), je nachdem index.
[in] sizeInBytes
Die Größe der timeZoneName Zeichenfolge in Bytes.
[in] index
Der Index eines der beiden Namen von Zeitzonen abzurufen.

Rückgabewert

Beliebige wenn der Vorgang erfolgreich war, andernfalls ein errno-Typwert.

Wenn entweder timeZoneNameNULList, oder sizeInBytes null oder kleiner als null (jedoch nicht beides) ist, wird ein ungültiger Parameter Handler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung ermöglicht wird, um fortzufahren, gibt diese Funktion errno legt diesen fest EINVAL und EINVALzurück.

Fehlerbedingungen

pReturnValue	timeZoneName	sizeInBytes	index	Rückgabewert	Inhalt von timeZoneName
Größe von TZ-Namen	NULL	0	0 oder 1	0	nicht geändert
Größe von TZ-Namen	alle	> 0	0 oder 1	0	TZ-Name
nicht geändert	NULL	> 0	alle	EINVAL	nicht geändert
nicht geändert	alle	0 (Null)	alle	EINVAL	nicht geändert
nicht geändert	alle	> 0	> 1	EINVAL	nicht geändert

Hinweise

Die Funktion ruft die Zeichenfolgen _get_tzname Zeitzonen Darstellung des Namens oder des Namens Tageslicht-Normalzeit-Zonen (DST) in die Adresse von timeZoneName je nach Indexwert zusammen mit der Größe der Zeichenfolge in pReturnValueab.Wenn timeZoneNameNULL ist und sizeInBytes (null) ist, ist die Größe der Zeichenfolge einer Zeitzone in Bytes in pReturnValuezurückgegeben.Mit Indexwerten müssen entweder 0 oder 1 für Tageslicht-Normalzeit-Zone für Normalzeit-Zone werden. alle anderen Werte des Indexes haben unbestimmte Ergebnisse.

Indexwerte

index	Inhalt von timeZoneName	timeZoneName Standardwert
0	Name der Zeitzonen	„PST“
1	Name Tageslicht-Normalzeit-Zonen	„PDT“
> 1 oder 0 <	errno festgelegt EINVAL	nicht geändert

Sofern die Werte explizit während der Laufzeit geändert werden, sind die Standardwerte „PST“ und „PDT“.Die Größen dieser Zeichenarrays werden durch TZNAME_MAX-Wert bestimmt.