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

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

RtlEqualUnicodeString

UNICODE_STRING