Função FsRtlAreNamesEqual (ntifs.h)
A rotina de FsRtlAreNamesEqual
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
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) |