次の方法で共有


EnumCalendarInfoExA 関数 (winnls.h)

識別子で指定されたロケールの予定表情報を列挙します。

メモ Windows Vista 以降でのみ実行されるアプリケーションでは、この関数を優先して EnumCalendarInfoExEx を使用する必要があります。
 

構文

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

パラメーター

[in] lpCalInfoEnumProcEx

アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumCalendarInfoProcEx」を参照してください。

[in] Locale

予定表情報を取得するロケールを指定するロケール識別子MAKELCID マクロを使用して識別子を作成するか、次のいずれかの定義済み値を使用できます。

Windows Vista 以降: 次のカスタム ロケール識別子もサポートされています。

[in] Calendar

情報が要求される予定表を指定する予定表識別子。 この識別子は、ロケールに関連付けられているすべての予定表を列挙するためにENUM_ALL_CALENDARSできることに注意してください。

[in] CalType

予定表情報の種類。 詳細については、「 カレンダーの種類情報」を参照してください。 この関数の呼び出しごとに指定できるカレンダーの種類は 1 つだけです。ただし、特に明記されている場合を除きます。

戻り値

成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。

  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効です。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。

解説

この関数は、 Calendar パラメーターの 値に応じて、指定したロケールまたは要求された 1 つの予定表に適用されるすべての予定表の予定表情報を列挙します。 関数は、指定されたアプリケーション定義のコールバック関数を呼び出して予定表情報を列挙します。 要求されたカレンダー情報を含むバッファーへのポインターをコールバック関数に渡します。 このプロセスは、 EnumCalendarInfoEx が 最後に該当する予定表を見つけるか、コールバック関数が FALSE を返すまで続行されます。

この関数は、 カスタム ロケールのデータを列挙できます。 データは、コンピューター間、またはアプリケーションの実行間で同じであるとは限りません。 アプリケーションでデータを永続化または送信する必要がある場合は、「 永続的なロケール データの使用」を参照してください。

この関数の ANSI バージョンを Unicode のみのロケール識別子と共に使用すると、オペレーティング システムでシステム コード ページが使用されるため、関数は成功する可能性があります。 ただし、システム コード ページで未定義の文字は、文字列に疑問符 (?) として表示されます。

注意

winnls.h ヘッダーは、EnumCalendarInfoEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winnls.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

予定表の種類の情報

EnumCalendarInfo

EnumCalendarInfoExEx

EnumCalendarInfoProcEx

EnumDateFormats

各国語サポート

各国語サポート関数