_get_tzname

[アーティクル]
08/09/2011

タイムゾーン名または夏時間標準タイムゾーン名 (DST) の文字列表現を取得します。

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

パラメーター

[出力] pReturnValue
終端の NULL 文字を含む timeZoneName の文字列の長さ。
[出力] timeZoneName
タイムゾーン名または夏時間標準タイムゾーン名 (DST) の文字列表現の index に基づいたアドレス。
[入力] sizeInBytes
timeZoneName 文字列のサイズ (バイト)。
[入力] index
取得する 2 つのタイムゾーン名の 1 つのインデックス。

戻り値

正常に終了した場合は 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	0	any	EINVAL	変更されない
変更されない	any	> 0	> 1	EINVAL	変更されない

解説

_get_tzname 関数は、タイムゾーン名または夏時間標準タイムゾーン名 (DST) の文字列表現を取得してインデックス値に基づいた timeZoneName のアドレスに格納し、文字列のサイズを pReturnValue に格納します。 timeZoneName が NULL で、sizeInBytes が 0 の場合は、いずれかのタイムゾーンの文字列のサイズ (バイト) のみが pReturnValue に返されます。インデックス値は、標準タイムゾーンの場合は 0、夏時間標準タイムゾーンの場合は 1 にする必要があります。インデックスにその他の値を指定すると、結果は不定になります。

インデックス値