RtlAnsiStringToUnicodeSize 宏 (wdm.h)
RtlAnsiStringToUnicodeSize 例程會傳回保存轉換成 Unicode 字元串之 ANSI 字串所需的位元組數目。
語法
//
// NTSYSAPI
// ULONG
// NTAPI
// RtlAnsiStringToUnicodeSize(
// PANSI_STRING AnsiString
// );
//
#define RtlAnsiStringToUnicodeSize(STRING) ( \
RtlxAnsiStringToUnicodeSize(STRING) \
)
參數
[in] STRING
包含 ANSI 字串的緩衝區指標。
傳回值
無
備註
RtlAnsiStringToUnicodeSize 會傳回 ULONG 值,其中包含保存轉換成 Unicode 字元串之 ANSI 字串所需的位元組數目。
將 RtlAnsiStringToUnicodeSize 例程的傳回值轉換成 USHORT 可能會導致數據遺失。 若要避免潛在的問題,此例程的呼叫端應該測試算術溢位的傳回值。 請注意,尾端 NULL 的 RtlAnsiStringToUnicodeSize 帳戶。
RtlAnsiStringToUnicodeSize 的呼叫端必須在 IRQL = PASSIVE_LEVEL上執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |