Funzione FsRtlNotifyFullReportChange (ntifs.h)

Articolo
12/21/2024

La routine FsRtlNotifyFullReportChange completa i 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'inizio di un elenco di notifiche. Ogni elemento nell'elenco è una struttura di notifica opaca.

[in] FullTargetName

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

[in] TargetNameOffset

Offset all'interno della FullTargetName stringa 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 del FullTargetName stringa, 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 sottodirectory.
FILE_ACTION_REMOVED	È stato eliminato un file o una sottodirectory.
FILE_ACTION_MODIFIED	Un file o una sottodirectory è stata modificata (ma non creata o eliminata).
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é il relativo 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 dispone già di 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

il FsRtlNotifyFullReportChange viene chiamato da un file system quando un file viene modificato in modo che sia possibile completare la notifica in sospeso ai runtime di integrazione delle modifiche.

FsRtlNotifyFullReportChange cerca una struttura di notifica nell'elenco delle notifiche corrispondente 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.

Fabbisogno

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)

Vedere anche

FsRtlNotifyFullChangeDirectory

Condividi tramite