EnumSystemCodePagesW 函式 (winnls.h)
列舉操作系統所安裝或支援的代碼頁。
語法
BOOL EnumSystemCodePagesW(
[in] CODEPAGE_ENUMPROCW lpCodePageEnumProc,
[in] DWORD dwFlags
);
參數
[in] lpCodePageEnumProc
應用程式定義回呼函式的指標。 EnumSystemCodePages 函式會藉由對這個回呼函式進行重複呼叫來列舉代碼頁。 如需詳細資訊,請參閱 EnumCodePagesProc。
[in] dwFlags
指定要列舉之代碼頁的旗標。 此參數可以有下列其中一個值,這些值互斥。
價值 | 意義 |
---|---|
|
僅列舉已安裝的代碼頁。 |
|
列舉所有支持的代碼頁。 |
傳回值
如果成功,則傳回非零值,否則傳回 0。 若要取得擴充的錯誤資訊,應用程式可以呼叫 getLastError
- ERROR_BADDB。 函式無法存取數據。 這種情況通常不應該發生,而且通常表示安裝不正確、磁碟問題或類似。
- ERROR_INVALID_FLAGS。 為旗標的值無效。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
言論
此函式會一次將代碼頁標識碼傳遞至指定的應用程式定義回呼函式,藉以列舉代碼頁。 此程式會繼續執行,直到所有已安裝或支援的代碼頁識別碼都傳遞至回呼函式,否則回呼函式會傳回 FALSE。
當應用程式使用此函式來判斷儲存數據的適當代碼頁時,應該盡可能使用 Unicode。 其他代碼頁不如廠商或操作系統之間的 Unicode 可攜式,因為相關標準的實作不同。
注意
winnls.h 標頭會將 EnumSystemCodePages 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
支援的最低伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平臺 | 窗戶 |
標頭 | winnls.h (包括 Windows.h) |
連結庫 | Kernel32.lib |
DLL | Kernel32.dll |