共用方式為

RtlUnicodeStringToAnsiString 函式 (winternl.h)

  • 發行項

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

語法

NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

參數

[in, out] DestinationString

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

[in] SourceString

包含要轉換成 ANSI 之來源字串 的UNICODE_STRING 結構。

[in] AllocateDestinationString

控制 DestinationString 的緩衝區空間配置。

TRUE

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

false

緩衝區空間未配置給 DestinationString。

傳回值

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

傳回碼 Description
STATUS_SUCCESS
 Unicode 字串已轉換為 ANSI。 否則，不會配置任何記憶體，也不會進行轉換。

備註

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

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

規格需求

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