Função FsRtlAreNamesEqual (ntifs.h)

A rotina FsRtlAreNamesEqual determina se duas cadeias de caracteres Unicode são iguais.

Sintaxe

BOOLEAN FsRtlAreNamesEqual(
  [in]           PCUNICODE_STRING ConstantNameA,
  [in]           PCUNICODE_STRING ConstantNameB,
  [in]           BOOLEAN          IgnoreCase,
  [in, optional] PCWCH            UpcaseTable
);

Parâmetros

[in] ConstantNameA

Um ponteiro para a primeira cadeia de caracteres. Não pode conter caracteres curinga.

[in] ConstantNameB

Um ponteiro para a segunda cadeia de caracteres. Não pode conter caracteres curinga.

[in] IgnoreCase

Defina como TRUE para correspondência que não diferencia maiúsculas de minúsculas ; caso contrário, FALSE.

[in, optional] UpcaseTable

Ponteiro opcional para a tabela de caracteres maiúsculas a ser usada para correspondência que não diferencia maiúsculas de minúsculas. Se esse valor não for fornecido, a tabela de caracteres maiúsculas do sistema padrão será usada.

Retornar valor

FsRtlAreNamesEqual retornará TRUE se as duas cadeias de caracteres Unicode corresponderem; caso contrário, FALSE .

Comentários

A tabela apontada por UpcaseTable é uma matriz de caracteres Unicode maiúsculos, indexados pelo caractere Unicode a ser convertido em maiúsculas. A matriz deve conter entradas para todos os caracteres que são legais em nomes de arquivo.

A correspondência que não diferencia maiúsculas de minúsculas é executada convertendo ambas as cadeias de caracteres em maiúsculas antes de serem comparadas. Portanto, o valor de UpcaseTable, se fornecido, será usado somente se IgnoreCase for TRUE.

Se ocorrer uma falha de alocação de pool, FsRtlAreNamesEqual gerará uma exceção STATUS_NO_MEMORY.

Para obter informações sobre outras rotinas de manipulação de cadeia de caracteres, consulte Rotinas da RTL (Biblioteca em Tempo de Execução).

Requisitos

Confira também

RtlEqualUnicodeString

UNICODE_STRING