GetNumberFormatW 函式 （winnls.h）
將數位字串格式化為針對標識元所指定地區設定所自定義的數位字串。
語法
int GetNumberFormatW(
[in] LCID Locale,
[in] DWORD dwFlags,
[in] LPCWSTR lpValue,
[in, optional] const NUMBERFMTW *lpFormat,
[out, optional] LPWSTR lpNumberStr,
[in] int cchNumber
);
參數
[in] Locale
指定地區設定的地區設定標識碼。 您可以使用 MAKELCID 巨集來建立地區設定識別碼，或使用下列其中一個預先定義的值。
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] dwFlags
控制函式作業的旗標。 如果 lpFormat 未設定 為 NULL，應用程式就必須將此參數設定為 0。 在此情況下，函式會使用使用者覆寫將字串格式化為地區設定的預設數位格式。 如果 lpFormat 設為 NULL，應用程式可以使用指定地區設定的系統預設數位格式來指定字串格式 LOCALE_NOUSEROVERRIDE。
[in] lpValue
包含要格式化之數位字串之 Null 終止字串的指標。 此字串只能包含下列字元。 所有其他字元都無效。 如果 lpValue 所指示的字串 偏離這些規則，則函式會傳回錯誤。
- 字元 “0” 到 “9”。
- 如果數位是浮點值，則為一個小數點（點）。
- 如果數位為負值，則為第一個字元位置的減號。
[in, optional] lpFormat
NUMBERFMT 的指標 結構，其中包含數位格式資訊，並將所有成員設定為適當的值。 如果此參數未設定為 NULL，則函式只會使用地區設定來格式化結構中未指定的資訊，例如負號的地區設定特定字串值。
[out, optional] lpNumberStr
這個函式擷取格式化數位字串的緩衝區指標。
[in] cchNumber
大小，以 TCHAR 值表示的數位字串緩衝區，lpNumberStr。 或者，應用程式可以將此參數設定為 0。 在此情況下，函式會傳回數位字串緩衝區所需的大小，而且不會使用 lpNumberStr 參數。
傳回值
傳回在緩衝區中擷取的 TCHAR 值數目，如果成功，lpNumberStr。 如果 cchNumber 參數
如果函式未成功，則傳回 0。 若要取得擴充的錯誤資訊，應用程式可以呼叫 getLastError
- ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大，或設定為 NULL不正確。
- ERROR_INVALID_FLAGS。 為旗標的值無效。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
- ERROR_OUTOFMEMORY。 沒有足夠的記憶體可以完成此作業。
言論
此函式可以從 自定義地區設定擷取數據。 數據不保證會從計算機到計算機，或在應用程式執行之間相同。 如果您的應用程式必須儲存或傳輸資料，請參閱使用永續性地區設定資料 。
當此函式的 ANSI 版本搭配僅限 Unicode 的地區設定識別碼使用時，函式可能會成功，因為操作系統會使用系統代碼頁。 不過，系統代碼頁中未定義的字元會以問號 （？） 的形式出現在字串中。
注意
winnls.h 標頭會將 GetNumberFormat 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winnls.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |