Função RtlUnicodeStringValidate (ntstrsafe.h)

  • Artigo

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

Sintaxe

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

Parâmetros

[in] SourceString

Um ponteiro para uma estrutura UNICODE_STRING a ser validada.

Retornar valor

RtlUnicodeStringValidate 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.
 

RtlUnicodeStringValidate retorna o valor STATUS_INVALID_PARAMETER quando ocorre 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.
Para obter informações sobre como testar valores NTSTATUS, consulte Usando valores NTSTATUS.

Comentários

O ponteiro SourceString não pode ser NULL. Se você precisar especificar um valor de ponteiro NULL , use a função RtlUnicodeStringValidateEx .

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

RtlUnicodeStringValidateEx

UNICODE_STRING