_get_tzname

發行項
02/28/2013

擷取的時區名稱或日光節約標準時區名稱 (DST) 的字元字串表示。

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

參數

[out] pReturnValue
字串長度的timeZoneName包括 NULL 結束字元。
[out] timeZoneName
字元字串表示的時區名稱或日光節約標準時區名稱 (DST) 的方式，取決於位址index。
[in] sizeInBytes
大小的timeZoneName字元字串，以位元組為單位。
[in] index
其中兩個時區名稱，擷取的索引。

傳回值

零如果成功的話，否則errno鍵入值。

如果其中一個timeZoneName是NULL，或sizeInBytes計數是零或小於零 (而非全部)，將不正確的參數處理常式會叫用，如所述參數驗證。如果執行，則允許繼續執行，這個函式會將errno到EINVAL ，並傳回EINVAL。

錯誤狀況

pReturnValue	timeZoneName	sizeInBytes	index	傳回值	內容timeZoneName
TZ 名稱的大小	NULL	0	0 或 1	0	不能修改
TZ 名稱的大小	任何	> 0	0 或 1	0	TZ 名稱
不能修改	NULL	> 0	任何	EINVAL	不能修改
不能修改	任何	零	任何	EINVAL	不能修改
不能修改	任何	> 0	> 1	EINVAL	不能修改

備註

_get_tzname函式會擷取的字元字串表示時區的名稱或日光節約標準時區名稱 (DST) 的位址timeZoneName索引值和字串的大小而定pReturnValue。如果timeZoneName是NULL和sizeInBytes是零，不論是哪一次以位元組為單位的區域中不會傳回字串的大小pReturnValue。索引值必須是標準時區為 0 或 1 日光節約標準時區。索引的任何其他值有未定的結果。

索引值