共用方式為

RtlAnsiStringToUnicodeString 函式 (winternl.h)

  • 發行項

將指定的 ANSI 來源字串轉換成 Unicode 字串。

語法

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

參數

[in, out] DestinationString

要保存已轉換 Unicode 字串 之UNICODE_STRING 結構的指標。 如果 AllocateDestinationString 為 TRUE，則例程會配置新的緩衝區來保存字串數據，並更新 DestinationString 的 Buffer 成員以指向新的緩衝區。 否則，例程會使用目前指定的緩衝區來保存字串。

[in] SourceString

ANSI_STRING 結構的指標，其中包含要轉換成 Unicode 的 ANSI 字串。

[in] AllocateDestinationString

控制目的地字串的緩衝區空間配置。

TRUE

緩衝空間會配置給 DestinationString。 如果設定為 TRUE，則必須使用 RtlFreeUnicodeString 解除分配緩衝區。

false

緩衝區空間未配置給 DestinationString。

傳回值

NTSTATUS 中定義了各種NTSTATUS值。H，以 Windows DDK 散發。

傳回碼 Description
STATUS_SUCCESS
 ANSI 字串已轉換成 Unicode。 失敗時，例程不會配置任何記憶體。

備註

翻譯會根據目前的系統地區設定資訊來完成。

如果呼叫端將 AllocateDestinationString 設定為 TRUE，則例程會將 DestinationString 的 Buffer 成員取代為其配置的緩衝區指標。 即使例程傳回錯誤狀態代碼，也可以覆寫舊的值。

因為此函式沒有匯入連結庫，所以您必須使用 GetProcAddress。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winternl.h
程式庫 ntdll.lib
Dll ntdll.dll