共用方式為


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

輸入字串的長度 (以字元為單位) ,包括空值終止字元。 如果此值為 -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 正規化範例中找到顯示使用此函式的範例。

需求

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

另請參閱

NORM_FORM

國家語言支援

國家語言支援函式

正規化字串

使用 Unicode 正規化來表示字串