_get_tzname

Статья
02/20/2013

Получает представление символьной строки имени часового пояса или часового пояса дневного света стандартного не).

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

Параметры

[исходящий] pReturnValue
длина строки timeZoneName включая НУЛЕВОЙ завершающий символ.
[исходящий] timeZoneName
Адрес строки символов для представления имени часового пояса или часового пояса дневного света стандартного не в зависимости от index.
[входящий] sizeInBytes
Размер timeZoneName символьная строка, в байтах.
[входящий] index
Индекс одним из 2 имен часового пояса, который необходимо извлечь.

Возвращаемое значение

Нуль, если оно завершится успешно, в противном случае значение 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 функция получает представление символьной строки имени часового пояса или часового пояса дневного света стандартного не в адрес timeZoneName в зависимости от значения индекса и размера строки в pReturnValue.If timeZoneName существует NULL и sizeInBytes нуля, просто размер строки любого возвращенного в часовом поясе в байтах pReturnValue.Значения индекса должно быть либо 0 для стандартного часового пояса или 1 для часового пояса стандарта дневного света. все остальные значения индекса имеют неопределённые результаты.

Значения индекса

index	Содержимое timeZoneName	timeZoneName значение по умолчанию
0	имя часового пояса	«PST»
1	Имя часового пояса дневного света standard	«PDT»
> 1 или 0 <	errno значение EINVAL	не было

Если значения явно не изменены во время выполнения значения по умолчанию «PST» и «PDT» соответственно.Размеры этих массивов знака управлены by TZNAME_MAX значения.