IdnToUnicode

国際化ドメイン名 (IDN) またはその他の国際化ラベルの Punycode 形式を、通常の Unicode UTF-16 エンコーディング構文に変換する。

IdnToUnicode dwFlags, lpASCIICharStr, cchASCIIChar, lpUnicodeCharStr, cchUnicodeChar

dwFlags : [int] 変換オプションを指定するフラグ。詳細な定義については、IdnToAscii の dwFlags パラメータを参照のこと。
lpASCIICharStr : [wstr] IDN またはその他の国際化ラベルの Punycode エンコーディングを表す文字列へのポインタ。この文字列は ASCII 文字のみで構成されている必要があり、Punycode エンコードされた Unicode を含むことができる。関数は Punycode の値を UTF-16 の値にデコードする。
cchASCIIChar : [int] lpASCIICharStr が示す入力文字列の文字数。
lpUnicodeCharStr : [wstr] 入力文字列の Punycode 値に対応する通常の Unicode UTF-16 エンコーディングを受け取るバッファへのポインタ。あるいは、cchUnicodeChar が 0 に設定されている場合、この関数はこのパラメータに NULL を取得することもできる。その場合、関数はこのバッファに必要なサイズを返す。
cchUnicodeChar : [int] lpUnicodeCharStr が示すバッファのサイズ (文字数)。アプリケーションがサイズを 0 に設定すると、lpUnicodeCharStr に NULL を取得し、関数に必要なバッファサイズを返させることができる。

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

解説

国際化ドメイン名 (IDN) またはその他の国際化ラベルの Punycode 形式を、通常の Unicode UTF-16
エンコーディング構文に変換する。

[戻り値]
成功した場合、lpUnicodeCharStr に取得された文字数を返す。取得された文字列は、入力文字列が NULL
終端されている場合にのみ NULL 終端される。関数が成功し、cchUnicodeChar の値が 0
の場合、必要なサイズを文字数で返す。これには入力バッファに含まれていれば終端 NULL 文字も含まれる。失敗した場合は 0
を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼び出す。次のいずれかのエラーコードが返される可能性がある:
このドキュメントは省略されている。

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

情報