codice di controllo FSCTL_DELETE_REPARSE_POINT

Articolo
02/07/2024

Il codice di controllo FSCTL_DELETE_REPARSE_POINT elimina un punto reparse dal file o dalla directory specificata. L'uso di FSCTL_DELETE_REPARSE_POINT non elimina il file o la directory.

Per eseguire questa operazione, chiamare ZwFsControlFile con i parametri seguenti.

I minifiltri devono usare FltUntagFile invece di FSCTL_DELETE_REPARSE_POINT per eliminare un reparse point.

Per altre informazioni sui reparse points e sul codice di controllo FSCTL_DELETE_REPARSE_POINT, vedere la documentazione di Microsoft Windows SDK.

Parametri

FileHandle [in]: handle di file per il file o la directory da cui deve essere eliminato il punto di analisi. Il chiamante deve avere accesso in scrittura al file o alla directory. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_DELETE_REPARSE_POINT per questa operazione.
InputBuffer [in]: puntatore a una struttura REPARSE_GUID_DATA_BUFFER o REPARSE_DATA_BUFFER . Il tag specificato nel membro ReparseTag di questa struttura deve corrispondere al tag del punto reparse da eliminare e il membro ReparseDataLength deve essere zero. Inoltre, se il reparse point è un reparse point di terze parti (non Microsoft), il GUID specificato nel membro ReparseGuid della struttura REPARSE_GUID_DATA_BUFFER deve corrispondere al GUID del punto di correzione da eliminare.
InputBufferLength [in]: dimensioni, in byte, del buffer a cui punta il parametro InputBuffer . Per una struttura REPARSE_GUID_DATA_BUFFER, questo valore deve essere esattamente REPARSE_GUID_DATA_BUFFER_HEADER_SIZE. Per una struttura REPARSE_DATA_BUFFER, questo valore deve essere esattamente REPARSE_DATA_BUFFER_HEADER_SIZE.
OutputBuffer [out]: Nessuno. Impostata su NULL.
OutputBufferLength [out]: impostato su 0.

Blocco dello stato

ZwFsControlFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice	Significato
STATUS_IO_REPARSE_DATA_INVALID	Uno dei valori dei parametri specificati non è valido. Si tratta di un codice di errore.
STATUS_IO_REPARSE_TAG_INVALID	Il tag reparse specificato dal chiamante non è valido. Si tratta di un codice di errore.
STATUS_IO_REPARSE_TAG_MISMATCH	Il tag reparse specificato dal chiamante non corrisponde al tag del reparse point da eliminare. Si tratta di un codice di errore.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Il reparse point è un reparse point di terze parti e il GUID reparse specificato dal chiamante non corrisponde al GUID del reparse point da eliminare. Si tratta di un codice di errore.