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。 アクションは正常に完了しましたが、結果は得われませんでした。
解説
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 |