Função RtlUnalignedStringCchLengthW (ntstrsafe.h)

  • Artigo

A função RtlUnalignedStringCchLengthW é uma versão da função RtlStringCchLength que aceita um ponteiro não alinhado para uma cadeia de caracteres Unicode.

Sintaxe

NTSTRSAFEDDI RtlUnalignedStringCchLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cchMax,
  [out, optional] size_t           *pcchLength
);

Parâmetros

[in] psz

Fornece um ponteiro para um buffer que contém uma cadeia de caracteres terminada em nulo cujo comprimento RtlUnalignedStringCchLengthW marcar.

[in] cchMax

Fornece o número máximo de caracteres permitidos no buffer para o qual psz aponta, incluindo o caractere NULL de terminação. Esse valor não pode exceder NTSTRSAFE_MAX_CCH.

[out, optional] pcchLength

Opcional. Se o chamador fornecer um ponteiro de endereço não NULL , a função carregará o endereço com o comprimento, em caracteres, da cadeia de caracteres contida no buffer para o qual psz aponta. O comprimento não inclui o caractere NULL de terminação da cadeia de caracteres.

Retornar valor

RtlUnalignedStringCchLengthW retorna um dos seguintes valores NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
 Esse êxito status significa que a cadeia de caracteres que o parâmetro psz não era NULL e o comprimento da cadeia de caracteres (incluindo o caractere NULL de terminação) era menor ou igual a caracteres cchMax.
STATUS_INVALID_PARAMETER
 Esse erro status significa que o valor em psz é NULL, cchMax é maior que NTSTRSAFE_MAX_CCH ou psz é maior que cchMax.
 

Para obter informações sobre como testar valores NTSTATUS, consulte Usando valores NTSTATUS.

Comentários

A função RtlUnalignedStringCchLengthW está disponível para arquiteturas de processador, como baseadas em Itanium e baseadas em x64, que causam exceções de alinhamento quando o software tenta acessar dados não alinhados. Nesses processadores, você pode usar RtlUnalignedStringCchLengthW em vez de RtlStringCchLength para evitar exceções de alinhamento. (Para processadores que não causam exceções de alinhamento, RtlUnalignedStringCchLengthW é equivalente a RtlStringCchLength.)

Para obter mais informações sobre as funções de cadeia de caracteres seguras, consulte Usando funções de cadeia de caracteres seguras.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP com Service Pack 1 (SP1) e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho ntstrsafe.h (inclua Ntstrsafe.h)
Biblioteca Ntstrsafe.lib
IRQL PASSIVE_LEVEL

Confira também

RtlStringCchLength