IsNormalizedString 函式 (winnls.h)
確認字串是否根據 Unicode 4.0 TR#15 正規化。 如需詳細資訊,請參閱 使用 Unicode 正規化來表示字串。
語法
BOOL IsNormalizedString(
[in] NORM_FORM NormForm,
[in] LPCWSTR lpString,
[in] int cwLength
);
參數
[in] NormForm
要使用的正規化表單。 NORM_FORM 指定標準 Unicode 正規化表單。
[in] lpString
要測試之字串的指標。
[in] cwLength
輸入字串的長度,以字元為單位,包括 Null 結束字元。 如果此值為 -1,函式會假設字串為 null 終止,並自動計算長度。
傳回值
如果輸入字串已經正規化為適當的格式,則傳回 TRUE ,否則傳回 FALSE 。 若要取得延伸的錯誤資訊,應用程式可以呼叫 GetLastError,這可以傳回下列其中一個錯誤碼:
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
- ERROR_NO_UNICODE_TRANSLATION。 在字串中找到不正確 Unicode。
- ERROR_SUCCESS。 動作已順利完成,但不會產生任何結果。
備註
Windows XP、Windows Server 2003:
不再支援。
必要的標頭檔與 DLL 是 Microsoft 國際化功能變數名稱 (IDN) 風險降低 API 的一部分,無法再下載。
範例
此函式的使用範例可在 NLS:Unicode 正規化範例中找到。
規格需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | winnls.h (包含 Windows.h) |
Dll | Normaliz.dll |
可轉散發套件 | Microsoft 國際化功能變數名稱 (IDN) SP2 和更新版本之 Windows XP 上的風險降低 API,或使用 SP1 的Windows Server 2003 |