驗證字串是否根據 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
輸入字串的長度 (以字元為單位) ,包括空值終止字元。 如果此值為 -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 正規化範例中找到顯示使用此函式的範例。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| Header | winnls.h (包括 Windows.h) |
| Library | 內核32。圖書館 |
| DLL | Normaliz.dll |
| 可再發行 | Windows XP SP2 和更新版本或 Windows Server 2003 SP1 上的 Microsoft 國際化網域名稱 (IDN) 風險降低 API |