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。 動作已順利完成,但不會產生任何結果。
如果您需要從錯誤狀況可靠地判斷 FALSE ,則必須呼叫 SetLastError (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

另請參閱

NORM_FORM

國家語言支援

國家語言支援函式

NormalizeString

使用 Unicode 正規化來表示字串