_get_tzname
Získá řetězcové vyjádření znaků název časového pásma nebo název zóny (běžný čas) letního času (DST).
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
Parametry
[out] pReturnValue
Délka řetězce timeZoneName včetně ukončovací znak NULL.[out] timeZoneName
Adresu řetězec znaků pro vyjádření název časového pásma nebo název zóny (běžný čas) letního času (DST) v závislosti na index.[in] sizeInBytes
Velikost timeZoneName znak řetězec v bajtech.[in] index
Index jeden z názvů dvou časové pásmo k načtení.
Vrácená hodnota
Nula v případě úspěchu, jinak errno zadejte hodnotu.
Pokud timeZoneName je NULL, nebo sizeInBytes je nula, nebo menší než nula (ale nikoli obě), je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, tato funkce nastaví errno na EINVAL a vrátí EINVAL.
Chybové podmínky
pReturnValue |
timeZoneName |
sizeInBytes |
index |
Návratová hodnota |
Obsah timeZoneName |
---|---|---|---|---|---|
Velikost Název TZ |
NULL |
0 |
0 nebo 1 |
0 |
nezměněno |
Velikost Název TZ |
any |
> 0 |
0 nebo 1 |
0 |
Název TZ |
nezměněno |
NULL |
> 0 |
any |
EINVAL |
nezměněno |
nezměněno |
any |
nula |
any |
EINVAL |
nezměněno |
nezměněno |
any |
> 0 |
> 1 |
EINVAL |
nezměněno |
Poznámky
_get_tzname Funkce načte řetězcové reprezentace znaků název časového pásma nebo název zóny (běžný čas) letního času (DST) na adresu timeZoneName v závislosti na hodnotě indexu a velikost řetězce v pReturnValue.Pokud timeZoneName je NULL a sizeInBytes je nula velikost řetězce buď časové zóny v bajtech, které je vráceno 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 |
Obsah timeZoneName |
timeZoneNameVýchozí hodnota |
---|---|---|
0 |
Název časového pásma |
"PST" |
1 |
Název zóny pro letní čas (běžný čas) |
"PDT." |
>1 nebo < 0 |
errnoChcete-li nastavitEINVAL |
nezměněno |
Není-li explicitně byly změněny hodnoty za běhu, výchozí hodnoty jsou "PST" a "PDT". Velikost pole 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. Pokud chcete volat standardní funkci jazyka C, použijte PInvoke. Další informace naleznete v tématu Příklady vyvolání platformy.