Função RtlUnicodeStringValidateEx (ntstrsafe.h)
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 for 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 |
---|---|
|
Esse sucesso status significa que a função foi concluída com êxito. |
|
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 dos seguintes 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.
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 | Qualquer se as cadeias de caracteres que estão sendo manipuladas estiverem sempre residentes na memória, caso contrário, PASSIVE_LEVEL |