_get_tzname

项目
02/21/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 大于零 (0)，而不是两个) 是零或小于零，无效参数调用处理程序，如参数验证所述。如果执行允许继续，此功能设置 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 夏时制标准时区的;索引的所有其他值具有不确定的结果。

索引值