_get_tzname

Makale
02/26/2013

Saat dilimi adı veya Yaz saati standart zaman bölge adı (dst) karakter dize gösterimini alır.

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

Parametreler

[Çıkış]pReturnValue
Dize uzunluğunu timeZoneName bir null Sonlandırıcı gibi.
[Çıkış]timeZoneName
Adresine bağlı olarak bir karakter dizesi için saat dilimi adı veya Yaz saati standart zaman bölge adı (dst) gösterimini index.
[in]sizeInBytes
Boyutunu timeZoneName karakter bayt dizesi.
[in]index
Dizine almak için iki saat dilimi adlarından biri.

Dönüş Değeri

Başarılı olursa, sıfır aksi bir errno değeri yazın.

timeZoneName Olan NULL, veya sizeInBytes sıfır veya sıfır (ancak ikisi birden değil)'den daha az bir geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilmişse, bu işlevi ayarlar errno için EINVAL ve EINVAL.

Hata koşulları

pReturnValue	timeZoneName	sizeInBytes	index	Dönüş değeri	İçeriğitimeZoneName
tz adının boyutu	NULL	0	0 veya 1	0	modifiye edilmemiş
tz adının boyutu	herhangi bir	> 0	0 veya 1	0	tz adı
modifiye edilmemiş	NULL	> 0	herhangi bir	EINVAL	modifiye edilmemiş
modifiye edilmemiş	herhangi bir	sıfır	herhangi bir	EINVAL	modifiye edilmemiş
modifiye edilmemiş	herhangi bir	> 0	> 1	EINVAL	modifiye edilmemiş

Notlar

_get_tzname İşlevi karakter dize gösterimine saat dilimi adı veya Yaz saati standart zaman bölge adı (dst) adresini alır timeZoneName dize boyutunu birlikte dizin değerine bağlı olarak pReturnValue.timeZoneName Olan NULL ve sizeInBytes yalnızca dize bayt bölgesinde bulunan döndürülür ya da zaman boyutu sıfır olan pReturnValue.Dizin değerleri standart saat dilimi için 0 ya da 1 gün ışığından yararlanma standart saat dilimi için olmalıdır; dizinin diğer değerlere sahip belirlenmemiş sonuçları.

Dizin değeri

index	İçeriğitimeZoneName	timeZoneNameVarsayılan değer
0	Saat dilimi adı	"PST"
1	Yaz standart saat dilimi adı	"PDT"
> 1 veya < 0	errnoayarlamakEINVAL	modifiye edilmemiş

Değerlerini çalıştırma sırasında açıkça değiştirmediyse varsayılan "pst" ve "pdt" sırasıyla değerlerdir.Bu karakter dizileri boyutları yönetilir TZNAME_MAX değeri.