Função RtlUnicodeStringValidate (ntstrsafe.h)

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	Qualquer se cadeias de caracteres que estão sendo manipuladas estiverem sempre residentes na memória, caso contrário, PASSIVE_LEVEL

Confira também

RtlUnicodeStringValidateEx

UNICODE_STRING