_get_tzname

發行項
06/09/2015

擷取時區或日光節約時間的標準時區名稱 (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 名稱的大小	any	> 0	0 或 1	0	TZ 命名
未修改	NULL	> 0	any	EINVAL	未修改
未修改	any	零	any	EINVAL	未修改
未修改	any	> 0	> 1	EINVAL	未修改

備註

_get_tzname 函式根據索引值擷取時區或日光節約時間時區名稱 (DST) 的字元字串至 timeZoneName 的位址，跟著表示字串大小的 pReturnValue。如果 timeZoneName 是 NULL ，而且 sizeInBytes 為零，只有任一個時區資料的大小 (以位元組為單位) 會以 pReturnValue 傳回。索引值必須是 0 代表標準時區時間或 1 代表日光節約標準時區;索引的任何其他值會導致不確定的結果。

索引值