RtlAnsiStringToUnicodeSize マクロ (wdm.h)

  • [アーティクル]

RtlAnsiStringToUnicodeSize ルーチンは、Unicode 文字列に変換された ANSI 文字列を保持するために必要なバイト数を返します。

構文

//
//  NTSYSAPI
//  ULONG
//  NTAPI
//  RtlAnsiStringToUnicodeSize(
//      PANSI_STRING AnsiString
//      );
//

#define RtlAnsiStringToUnicodeSize(STRING) (                 \
    RtlxAnsiStringToUnicodeSize(STRING)                      \
)

パラメーター

[in] STRING

ANSI 文字列を含むバッファーへのポインター。

戻り値

なし

解説

RtlAnsiStringToUnicodeSize は、Unicode 文字列に変換された ANSI 文字列を保持するために必要なバイト数を含む ULONG 値を返します。

RtlAnsiStringToUnicodeSize ルーチンの戻り値を USHORT にキャストすると、データが失われる可能性があります。 潜在的な問題を回避するために、このルーチンの呼び出し元は算術オーバーフローの戻り値をテストする必要があります。 RtlAnsiStringToUnicodeSize は末尾の NULL を考慮します。

RtlAnsiStringToUnicodeSize の呼び出し元は、IRQL = PASSIVE_LEVELで実行されている必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 以降で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL

こちらもご覧ください

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize