_get_tzname
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.
Gereksinimler
Yordamı |
Gerekli başlık |
---|---|
_get_tzname |
<time.h> |
Daha fazla bilgi için bkz. Uyumluluk.
.NET Framework Eşdeğeri
Yoktur. Standart c işlevi çağırmak için kullanmak PInvoke. Daha fazla bilgi için bkz: Platform Çağırma örnekleri.