8 ビット Unicode 変換形式 (UTF-8) コード ページを使用して、指定したソース文字列を Unicode 文字列に変換します。
構文
NTSTATUS WINAPI RtlUTF8ToUnicodeN(
_Out_ PWSTR UnicodeStringDestination,
_In_ ULONG UnicodeStringMaxByteCount,
_Out_opt_ PULONG UnicodeStringActualByteCount,
_In_ PCCH UTF8StringSource,
_In_ ULONG UTF8StringByteCount
);
パラメーター
-
UnicodeStringDestination [out]
-
変換された文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。
-
UnicodeStringMaxByteCount [in]
-
UnicodeStringDestination で書き込まれる最大バイト数。 この値によって変換された文字列が切り捨てられる場合、 RtlUTF8ToUnicodeN はエラー状態を返します。
-
UnicodeStringActualByteCount [out, optional]
-
変換された文字列の長さをバイト単位で受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、NULL できます。 文字列が切り捨てられた場合、返される数値は、実際に切り捨てられた文字列数をカウントします。
-
UTF8StringSource [in]
-
変換する文字列へのポインター。
-
UTF8StringByteCount [in]
-
UTF8StringSource の文字列のサイズ (バイト単位)。
戻り値
RtlUTF8ToUnicodeN は 、次のいずれかの NTSTATUS 値を返します。
| リターン コード | 説明 |
|---|---|
|
文字列が Unicode に変換されました。 |
|
無効な入力文字が検出され、置き換えられました。 この状態は成功状態と見なされます。 |
|
UnicodeStringDestination と UnicodeStringActualByteCount への両方のポインターが NULL でした。 |
|
UTF8StringSource が NULL でした。 |
|
UnicodeStringDestination が切り捨てられました。 |
注釈
UnicodeStringActualByteCount は省略可能で NULL でもかまいませんが、呼び出し元はストレージを提供する必要があります。これは、受信した長さを使用して変換が成功したかどうかを判断できるためです。
出力が切り捨てられ、無効な入力文字が検出された場合、関数はエラー STATUS_BUFFER_TOO_SMALL返します。
UnicodeStringDestination が NULL に設定されている場合、関数は UnicodeStringActualByteCount で切り捨てることなく、翻訳された文字列をホストするために必要なバイト数を返します。
UnicodeStringDestination ポインターと UTF8StringSource ポインターが等しい場合を除き、RtlUTF8ToUnicodeN はソース文字列を変更しません。 返された Unicode 文字列は null で終わるものではありません。
RtlUTF8ToUnicodeN の呼び出し元は IRQL < DISPATCH_LEVELで実行されている必要があります。
要求事項
| 要件 | 価値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 R2 [デスクトップ アプリのみ] |
| ヘッダ |
|
| [DLL] |
|
こちらも参照ください
-
RtlUnicodeToUTF8Nをする