EnumSystemCodePagesW 関数 (winnls.h)
オペレーティング システムにインストールされているか、オペレーティング システムでサポートされているコード ページを列挙します。
構文
BOOL EnumSystemCodePagesW(
[in] CODEPAGE_ENUMPROCW lpCodePageEnumProc,
[in] DWORD dwFlags
);
パラメーター
[in] lpCodePageEnumProc
アプリケーション定義のコールバック関数へのポインター。 EnumSystemCodePages 関数は、このコールバック関数を繰り返し呼び出すことによってコード ページを列挙します。 詳細については、「 EnumCodePagesProc」を参照してください。
[in] dwFlags
列挙するコード ページを指定するフラグ。 このパラメーターには、相互に排他的な次のいずれかの値を指定できます。
| 値 | 意味 |
|---|---|
|
インストールされているコード ページのみを列挙します。 |
|
サポートされているすべてのコード ページを列挙します。 |
戻り値
成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。
- ERROR_BADDB。 関数がデータにアクセスできませんでした。 この状況は、通常は発生するべきではありません。通常は、インストールが正しくないことを示します。ディスクの問題などです。
- ERROR_INVALID_FLAGS。 フラグに指定された値が無効です。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。
注釈
この関数は、指定されたアプリケーション定義のコールバック関数に一度に 1 つずつコード ページ識別子を渡すことによって、コード ページを列挙します。 このプロセスは、インストールまたはサポートされているすべてのコード ページ識別子がコールバック関数に渡されるか、コールバック関数が FALSE を返すまで続行されます。
アプリケーションがこの関数を使用してデータを保存するための適切なコード ページを決定する場合は、可能な場合は Unicode を使用する必要があります。 他のコード ページは、関連する標準の実装が異なるために、ベンダーやオペレーティング システム間で Unicode ほど移植性がありません。
注意
winnls.h ヘッダーは、EnumSystemCodePages をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnls.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |