Função RtlUnicodeStringValidateEx (ntstrsafe.h)

  • Artigo

A função RtlUnicodeStringValidateEx valida o conteúdo de uma estrutura UNICODE_STRING .

Sintaxe

NTSTRSAFEDDI RtlUnicodeStringValidateEx(
  [in] PCUNICODE_STRING SourceString,
  [in] DWORD            dwFlags
);

Parâmetros

[in] SourceString

Opcional. Um ponteiro para uma estrutura UNICODE_STRING a ser validada. Esse ponteiro pode ser NULL, mas somente se STRSAFE_IGNORE_NULLS estiver definido em dwFlags.

[in] dwFlags

O seguinte sinalizador é definido:

STRSAFE_IGNORE_NULLS

Se esse sinalizador estiver definido, o ponteiro de origem poderá ser NULL. RtlUnicodeStringValidateEx trata ponteiros de buffer de origem NULL como cadeias de caracteres vazias (TEXT("")).

Retornar valor

RtlUnicodeStringValidateEx retorna um dos seguintes valores NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
 Esse êxito status significa que a função foi concluída com êxito.
STATUS_INVALID_PARAMETER
 Esse erro status significa que a função recebeu um parâmetro de entrada inválido. Para obter mais informações, consulte a lista a seguir.
 

Se STRSAFE_IGNORE_NULLS não estiver definido em dwFlags, RtlUnicodeStringValidateEx retornará o valor STATUS_INVALID_PARAMETER quando ocorrer um destes procedimentos:

  • SourceString->Tamanho % sizeof(WCHAR) não é igual a zero.
  • SourceString->MaximumLength % sizeof(WCHAR) não é igual a zero.
  • SourceString->O comprimento é maior que SourceString->MaximumLength.
  • SourceString->MaximumLength é maior que NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
  • SourceString->O buffer é igual a NULL , mas SourceString->Length ou SourceString->MaximumLength não é igual a zero.
  • Um sinalizador inválido é especificado para dwFlags.
Para obter informações sobre como testar valores NTSTATUS, consulte Usando valores NTSTATUS.

Comentários

O ponteiro SourceString não pode ser NULL , a menos que o sinalizador STRSAFE_IGNORE_NULLS esteja definido.

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

RtlUnicodeStringValidate

UNICODE_STRING