IdnToNameprepUnicode

国際化ドメイン名 (IDN) またはその他の国際化ラベルを Network Working Group RFC 3491 で規定された NamePrep 形式に変換する。ただし、Punycode への追加変換は行わない。

IdnToNameprepUnicode dwFlags, lpUnicodeCharStr, cchUnicodeChar, lpNameprepCharStr, cchNameprepChar

dwFlags : [int] 変換オプションを指定するフラグ。詳細は IdnToAscii の dwFlags パラメータを参照のこと。
lpUnicodeCharStr : [wstr] IDN またはその他の国際化ラベルを表す Unicode 文字列へのポインタ。
cchUnicodeChar : [int] lpUnicodeCharStr が示す入力 Unicode 文字列内の Unicode 文字数。
lpNameprepCharStr : [wstr] NamePrep 処理によって変換された入力 Unicode 文字列を受け取るバッファへのポインタ。代わりに cchNameprepChar が 0 の場合は NULL を指定でき、この場合は関数がバッファに必要なサイズを返す。
cchNameprepChar : [int] lpNameprepCharStr が指すバッファのサイズ(文字数単位)。アプリケーションはサイズを 0 に設定して、lpNameprepCharStr に NULL を指定し、関数に必要なバッファサイズを返させることができる。

(プラグイン / モジュール : kernel32.dll)

解説

国際化ドメイン名 (IDN) またはその他の国際化ラベルを Network Working Group RFC 3491 で規定された
NamePrep 形式に変換する。ただし、Punycode への追加変換は行わない。

[戻り値]
成功した場合、lpNameprepCharStr に取得された文字数を返す。取得された文字列は、入力 Unicode 文字列が null
終端である場合に限り null 終端となる。関数が成功して cchNameprepChar の値が 0 の場合、入力バッファに終端
null 文字が含まれていたならそれを含む必要サイズ(文字数)を返す。失敗した場合は 0
を返す。拡張エラー情報を取得するには、アプリケーションから GetLastError を呼ぶ。次のいずれかのエラーコードが返る場合がある:
(以下省略)

[備考]
IdnToAscii の Remarks を参照のこと。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs