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 Internationalized Domain Name (IDN) 軽減 API on Windows XP with SP2 以降、または Windows Server 2003 sp1

関連項目

NORM_FORM

各国語サポート

各国語サポート関数

NormalizeString

Unicode 正規化を使用して文字列を表す