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 を呼び出すことができます。これにより、次のいずれかのエラーコードが返されます。

エラー条件から 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