Macro RtlAnsiStringToUnicodeSize (wdm.h)

  • Artigo

A rotina RtlAnsiStringToUnicodeSize retorna o número de bytes necessários para manter uma cadeia de caracteres ANSI convertida em uma cadeia de caracteres Unicode.

Sintaxe

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

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

Parâmetros

[in] STRING

Ponteiro para um buffer que contém a cadeia de caracteres ANSI.

Retornar valor

Nenhum

Comentários

RtlAnsiStringToUnicodeSize retorna um valor ULONG que contém o número de bytes necessários para manter uma cadeia de caracteres ANSI convertida em uma cadeia de caracteres Unicode.

Converter o valor retornado da rotina RtlAnsiStringToUnicodeSize no USHORT pode causar uma perda de dados. Para evitar possíveis problemas, os chamadores dessa rotina devem testar o valor retornado para estouro aritmético. Observe que RtlAnsiStringToUnicodeSize conta para o NULL à direita.

Os chamadores de RtlAnsiStringToUnicodeSize devem estar em execução em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize