Compartilhar via


Função FsRtlAreNamesEqual (ntifs.h)

A rotina de 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 é possível conter caracteres curinga.

[in] ConstantNameB

Um ponteiro para a segunda cadeia de caracteres. Não é possível conter caracteres curinga.

[in] IgnoreCase

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

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

Valor de retorno

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

Observações

A tabela apontada por UpcaseTable é uma matriz de caracteres Unicode maiúsculos, indexados pelo caractere Unicode a serem convertidos 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 VERDADEIRO.

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 tratamento de cadeias de caracteres, consulte Run-Time Rotinas da Biblioteca de Run-Time (RTL).

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho ntifs.h (inclua Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

RtlEqualUnicodeString

UNICODE_STRING