_get_tzname
Načte řetězec reprezentace znaků název časového pásma nebo název zóny letní standardní čas (DST).
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
Parametry
[výstup]pReturnValue
Délka řetězce timeZoneName včetně ukončovací znak NULL.[výstup]timeZoneName
Adresa řetězec znaků pro znázornění časové pásmo název nebo název zóny letní standardní čas (DST) v závislosti na index.[v]sizeInBytes
Velikost timeZoneName v bajtech řetězec znaků.[v]index
Index jeden z názvů dvou časové pásmo načíst.
Vrácená hodnota
Nula, pokud je úspěšná, jinak errno zadejte hodnotu.
Pokud timeZoneName je NULL, nebo sizeInBytes je nulové nebo menší než nula (ale ne obě), je vyvolána obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, tato funkce nastaví errno na EINVAL a vrátí EINVAL.
Chybové podmínky
pReturnValue |
timeZoneName |
sizeInBytes |
index |
Vrácená hodnota |
ObsahtimeZoneName |
---|---|---|---|---|---|
velikost názvu TZ |
NULL |
0 |
0 nebo 1 |
0 |
Nezměněno |
velikost názvu TZ |
žádné |
> 0 |
0 nebo 1 |
0 |
Název TZ |
Nezměněno |
NULL |
> 0 |
žádné |
EINVAL |
Nezměněno |
Nezměněno |
žádné |
nula |
žádné |
EINVAL |
Nezměněno |
Nezměněno |
žádné |
> 0 |
> 1 |
EINVAL |
Nezměněno |
Poznámky
_get_tzname Funkce načte řetězec reprezentace znaků název časového pásma nebo název zóny letní standardní čas (DST) do adresy timeZoneName v závislosti na hodnotě indexu spolu s velikost řetězce v pReturnValue.Pokud timeZoneName je NULL a sizeInBytes je nula, stačí velikost řetězce buď časové pásmo v bajtech je vrácena v pReturnValue.Hodnoty indexu musí být pro standardní časové pásmo 0 nebo 1 pro letní standardní časové pásmo; hodnoty indexu mít neurčeného výsledky.
Hodnoty indexu
index |
ObsahtimeZoneName |
timeZoneNameVýchozí hodnota |
---|---|---|
0 |
Název časového pásma |
"PST" |
1 |
Název zóny letní (běžný čas) |
"PDT" |
> 1 nebo < 0 |
errnonastavitEINVAL |
Nezměněno |
Pokud není výslovně změně hodnot v době spuštění, výchozí hodnoty jsou "PST" a "PDT".Velikosti polí těchto znaků se řídí TZNAME_MAX hodnotu.
Požadavky
Rutina |
Požadované záhlaví |
---|---|
_get_tzname |
<time.h> |
Další informace naleznete v tématu Kompatibilita.
Ekvivalent v rozhraní .NET Framework
Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.