Funzione FsRtlNotifyFullReportChange (ntifs.h)

  • Articolo

La routine FsRtlNotifyFullReportChange completa il runtime di integrazione delle modifiche in sospeso.

Sintassi

void FsRtlNotifyFullReportChange(
  [in]           PNOTIFY_SYNC NotifySync,
  [in]           PLIST_ENTRY  NotifyList,
  [in]           PSTRING      FullTargetName,
  [in]           USHORT       TargetNameOffset,
  [in, optional] PSTRING      StreamName,
  [in, optional] PSTRING      NormalizedParentName,
  [in]           ULONG        FilterMatch,
  [in]           ULONG        Action,
  [in, optional] PVOID        TargetContext
);

Parametri

[in] NotifySync

Puntatore a un oggetto di sincronizzazione opaco per il volume corrente.

[in] NotifyList

Puntatore all'intestazione di un elenco di notifiche. Ogni elemento nell'elenco è una struttura di notifica opaca.

[in] FullTargetName

Puntatore a una stringa ANSI o Unicode che contiene il percorso completo del file.

[in] TargetNameOffset

Offset all'interno della stringa FullTargetName del componente finale del nome.

[in, optional] StreamName

Puntatore facoltativo a una stringa ANSI o Unicode che contiene un nome di flusso da archiviare con il nome del file.

[in, optional] NormalizedParentName

Puntatore facoltativo a una stringa ANSI o Unicode che contiene lo stesso percorso della stringa FullTargetName , ma con tutti i nomi brevi sostituiti dai nomi lunghi corrispondenti.

[in] FilterMatch

Maschera di bit dei flag da confrontare con il filtro di completamento nella struttura di notifica. Se uno dei bit corrispondenti nel filtro di completamento è impostato, esiste una condizione di notifica. Per i possibili valori di flag, vedere il parametro CompletionFilter di FsRtlNotifyFullChangeDirectory.

[in] Action

Specifica il codice azione da archiviare nel buffer dell'utente, se presente. Il codice azione può essere uno dei valori descritti di seguito.

Codice azione Significato
FILE_ACTION_ADDED È stato creato un nuovo file o una sottodirectory.
FILE_ACTION_REMOVED Un file o una sottodirectory è stato eliminato.
FILE_ACTION_MODIFIED Un file o una sottodirectory è stato modificato (ma non è stato creato o eliminato).
FILE_ACTION_RENAMED_OLD_NAME Si tratta del nome precedente di un file rinominato.
FILE_ACTION_RENAMED_NEW_NAME Si tratta del nuovo nome di un file rinominato.
FILE_ACTION_ADDED_STREAM È stato aperto un nuovo flusso.
FILE_ACTION_REMOVED_STREAM Un flusso è stato chiuso.
FILE_ACTION_MODIFIED_STREAM Un flusso è stato modificato (ma non aperto o chiuso).
FILE_ACTION_REMOVED_BY_DELETE Un ID oggetto è stato rimosso dall'indice da un'operazione di eliminazione del file.
FILE_ACTION_ID_NOT_TUNNELLED Impossibile eseguire il tunneling di un ID oggetto per un file perché l'ID oggetto corrisponde all'ID di un file già esistente.
FILE_ACTION_TUNNELLED_ID_COLLISION Impossibile eseguire il tunneling di un ID oggetto per un file perché il file ha già un ID oggetto.

[in, optional] TargetContext

Puntatore di contesto da passare al file system se si esegue un controllo di attraversamento nel caso di un albero controllato. Per altre informazioni, vedere il parametro TraverseCallback di FsRtlNotifyFullChangeDirectory.

Valore restituito

nessuno

Osservazioni

FsRtlNotifyFullReportChange viene chiamato da un file system quando viene modificato un file in modo che sia possibile completare gli IRP delle modifiche in sospeso.

FsRtlNotifyFullReportChange cerca una struttura di notifica nell'elenco di notifica che corrisponde al filtro e al nome percorso specificati. Se viene trovata una corrispondenza, FsRtlNotifyFullReportChange completa tutti i runtime di integrazione in sospeso per la struttura di notifica.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

FsRtlNotifyFullChangeDirectory