Funzione FsRtlDissectName (ntifs.h)

Data una stringa pathname Unicode, la routine FsRtlDissectName restituisce due stringhe, una contenente il primo nome file trovato nella stringa, l'altra contenente la parte rimanente non analizzata della stringa pathname.

Sintassi

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

Parametri

[in] Path

Stringa pathname da analizzare.

[out] FirstName

Puntatore al primo nome file nella stringa pathname.

[out] RemainingName

Puntatore alla parte rimanente non analizzata della stringa pathname.

Valore restituito

Nessuno

Osservazioni

Nella stringa di input le barre rovesciata vengono lette come separatori dei nomi. Si presuppone che il nome nella stringa sia costituito da tutti i caratteri dall'inizio della stringa al carattere che precede la prima barra rovesciata, inclusiva. Esiste una sola eccezione a questa regola: se il primo carattere nella stringa di input è una barra rovesciata, questo carattere viene ignorato e non viene visualizzato nella stringa di output. La parte rimanente della stringa è costituita da tutti i caratteri che seguono la barra rovesciata che segue il nome trovato nella stringa.

FsRtlDissectName non verifica la presenza di caratteri non validi nella stringa di input.

La tabella seguente illustra i valori di input e output di esempio per FsRtlDissectName.

Si noti che al momento della restituzione, i membri buffer di dei parametri di output punteranno al membro buffer di Path. Di conseguenza, il chiamante non deve allocare spazio di archiviazione per i membri Buffer dei due parametri di output, come illustrato nell'esempio seguente:

.
.
.
/*
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);
.
.
.

Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).

Fabbisogno

Vedere anche

UNICODE_STRING