Função FsRtlDissectName (ntifs.h)

Artigo
12/21/2024

Dada uma cadeia de caracteres de nome de caminho Unicode, o FsRtlDissectName rotina retorna duas cadeias de caracteres, uma contendo o primeiro nome de arquivo encontrado na cadeia de caracteres, a outra que contém a parte restante desparsada da cadeia de caracteres pathname.

Sintaxe

void FsRtlDissectName(
  [in]  UNICODE_STRING  Path,
  [out] PUNICODE_STRING FirstName,
  [out] PUNICODE_STRING RemainingName
);

Parâmetros

[in] Path

Cadeia de caracteres pathname a ser analisada.

[out] FirstName

Ponteiro para o nome do primeiro arquivo na cadeia de caracteres pathname.

[out] RemainingName

Ponteiro para a parte nãoparsada restante da cadeia de caracteres pathname.

Valor de retorno

Nenhum

Observações

Na cadeia de caracteres de entrada, as barras invertidas são lidas como separadores de nome. Supõe-se que o primeiro nome na cadeia de caracteres consista em todos os caracteres desde o início da cadeia de caracteres até o caractere anterior à primeira barra invertida, inclusive. Há apenas uma exceção a essa regra: se o primeiro caractere na cadeia de caracteres de entrada for uma barra invertida, esse caractere será ignorado e não aparecerá na cadeia de caracteres de saída. A parte restante da cadeia de caracteres consiste em todos os caracteres seguindo a barra invertida que segue o nome encontrado na cadeia de caracteres.

FsRtlDissectName não verifica a presença de caracteres ilegais na cadeia de caracteres de entrada.

A tabela a seguir mostra valores de entrada e saída de exemplo para FsRtlDissectName.

Caminho	FirstName	RemainingName
vazio	vazio	vazio
Um	Um	vazio
A\B\C\D\E	Um	B\C\D\E
*Um?	*Um?	vazio
\Um	Um	vazio
A[,]	A[,]	vazio
A\\B+;\C	Um	\B+;\C

Observe que, ao retornar, os membros do buffer de dos parâmetros de saída apontarão para o membro do Buffer do Path. Portanto, o chamador não deve alocar armazenamento para o buffer membros dos dois parâmetros de saída, conforme mostrado no exemplo a seguir:

.
.
.
/*
The FsRtlDissectName routine will set the members
of the following two structures appropriately:
*/
UNICODE_STRING CurrentComponent;
UNICODE_STRING RemainingComponent;

/*
Do not allocate storage for the Buffer members of CurrentComponent
and RemainingComponent in that they will point into the previously
allocated storage of FullPathName's Buffer member:
*/
FsRtlDissectName (FullPathName, &CurrentComponent, &RemainingComponent);
.
.
.

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

UNICODE_STRING

Compartilhar via