GetCalendarInfoEx

名前で指定したロケールのカレンダーに関する情報を取得する。注意: アプリケーションが Windows Vista 以降でのみ動作するように設計されている場合、GetCalendarInfo よりこの関数を優先して呼び出すべきである。注意: この関数はリリース間で変化し得るデータ（たとえばカスタムロケール由来のもの）を取得することがある。アプリケーションがデータを永続化または送信する必要がある場合は、Using Persistent Locale Data を参照。

GetCalendarInfoEx lpLocaleName, Calendar, lpReserved, CalType, lpCalData, cchData, lpValue

lpLocaleName : [wstr] ロケール名、または次の定義済み値のいずれかへのポインタ。
Calendar : [int] カレンダー識別子。
lpReserved : [wstr] 予約。NULL を指定する必要がある。
CalType : [int] 取得する情報の種類。詳細は Calendar Type Information を参照。
lpCalData : [wstr] 要求されたデータを文字列としてこの関数が取得するバッファへのポインタ。CalType に CAL_RETURN_NUMBER が指定されている場合、このパラメータは NULL を取得する必要がある。
cchData : [int] lpCalData バッファのサイズを文字数で指定する。アプリケーションはこのパラメータを 0 に設定することで、カレンダーデータバッファに必要なサイズを取得できる。その場合、lpCalData パラメータは使われない。CalType に CAL_RETURN_NUMBER が指定されている場合、cchData の値は 0 でなければならない。
lpValue : [var] 要求されたデータを数値として受け取る変数へのポインタ。CalType に CAL_RETURN_NUMBER が指定されている場合、lpValue は NULL であってはならない。CalType に CAL_RETURN_NUMBER が指定されていない場合、lpValue は NULL でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

名前で指定したロケールのカレンダーに関する情報を取得する。注意: アプリケーションが Windows Vista
以降でのみ動作するように設計されている場合、GetCalendarInfo よりこの関数を優先して呼び出すべきである。注意:
この関数はリリース間で変化し得るデータ（たとえばカスタムロケール由来のもの）を取得することがある。アプリケーションがデータを永続化または送信する必要がある場合は、Using
Persistent Locale Data を参照。

[戻り値]
成功した場合、lpCalData バッファに取得された文字数を返す。関数が成功し、cchData が 0
に設定され、CAL_RETURN_NUMBER
が指定されていない場合、戻り値はロケール情報を保持するのに必要なバッファサイズである。関数が成功し、cchData が 0
に設定され、CAL_RETURN_NUMBER が指定されている場合、戻り値は lpValue
パラメータに書き込まれた値のサイズである。このサイズは常に 2 である。成功しなかった場合は 0 を返す。拡張エラー情報を取得するには
GetLastError を呼び出すことができ、次のいずれかのエラーコードが返ることがある。
（以下省略）

[備考]
注意: この API は 2019 年 5
月の日本の改元に対応するために更新中である。アプリケーションが日本のカレンダーをサポートする場合、新しい時代を正しく扱えることを検証する必要がある。詳細は「日本の改元に向けてアプリケーションを準備する」を参照。Windows
8 以降: アプリケーションが Windows.Globalization 名前空間の言語タグをこの関数に渡す場合、まず
ResolveLocaleName を呼び出してタグを変換する必要がある。

情報