_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
索引检索的两个时区名称之一。

返回值

如果成功则为0，否则为 errno 类型值。

如果或 timeZoneName 为 NULL，或其 sizeInBytes 为零或小于零 (0)，但不能两者)，的参数无效处理程序，如参数验证所述。如果允许执行继续，则该函数设置 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 标准时区的夏时制标准时区的；其他所有值索引具有不确定的结果。

索引