FsRtlNotifyFullChangeDirectory-Funktion (ntifs.h)

Die FsRtlNotifyFullChangeDirectory Routine erstellt eine Benachrichtigungsstruktur für eine Benachrichtigungsanforderung und fügt sie der angegebenen Benachrichtigungsliste hinzu.

Syntax

void FsRtlNotifyFullChangeDirectory(
  [in]           PNOTIFY_SYNC               NotifySync,
  [in]           PLIST_ENTRY                NotifyList,
  [in]           PVOID                      FsContext,
  [in]           PSTRING                    FullDirectoryName,
  [in]           BOOLEAN                    WatchTree,
  [in]           BOOLEAN                    IgnoreBuffer,
  [in]           ULONG                      CompletionFilter,
  [in, optional] PIRP                       NotifyIrp,
  [in, optional] PCHECK_FOR_TRAVERSE_ACCESS TraverseCallback,
  [in, optional] PSECURITY_SUBJECT_CONTEXT  SubjectContext
);

Parameter

[in] NotifySync

Ein Zeiger auf ein undurchsichtiges Synchronisierungsobjekt für die Benachrichtigungsliste für das aktuelle Volume.

[in] NotifyList

Ein Zeiger auf den Kopf einer Benachrichtigungsliste. Jedes Element in der Liste ist eine undurchsichtige Benachrichtigungsstruktur.

[in] FsContext

Ein Zeiger auf einen eindeutigen Wert, der vom Dateisystem zugewiesen wird, um die zu erstellende Benachrichtigungsstruktur zu identifizieren, die zu einem bestimmten Dateiobjekt gehört. Wenn eine TraverseCallback- Routine angegeben wird, wird FsContext- als NotifyContext Parameter an diese Routine übergeben.

[in] FullDirectoryName

Ein Zeiger auf eine ANSI- oder Unicode-Zeichenfolge, die den vollständigen Namen für das Verzeichnis enthält, das dieser Benachrichtigungsstruktur zugeordnet ist. Wird ignoriert, wenn NotifyIrp- NULL ist.

[in] WatchTree

Auf TRUE festgelegt, wenn auch alle Unterverzeichnisse dieses Verzeichnisses überwacht werden sollen. Auf FALSE festgelegt, wenn nur das Verzeichnis selbst überwacht werden soll. Wird ignoriert, wenn NotifyIrp- NULL ist.

[in] IgnoreBuffer

Auf TRUE festgelegt, um alle Benutzerpuffer zu ignorieren und zu erzwingen, dass das Verzeichnis erneut aufgezählt wird. Diese Aktion beschleunigt den Vorgang. Wird ignoriert, wenn NotifyIrp- NULL ist.

[in] CompletionFilter

Bitmaske von Flags, die die Typen von Änderungen an Dateien oder Unterverzeichnissen angeben, die dazu führen sollten, dass die Warteschlange ausstehende Benachrichtigungs-IRPs abgeschlossen wird. In der folgenden Tabelle werden die möglichen Flagwerte beschrieben.

CompletionFilter- wird ignoriert, wenn NotifyIrp- NULL ist.

[in, optional] NotifyIrp

Ein Zeiger auf das IRP, um die Änderung zu benachrichtigen. Wenn NotifyIrp NULL ist, bedeutet dies, dass der durch dieses Dateiobjekt dargestellte Dateidatenstrom gelöscht wird.

[in, optional] TraverseCallback

Optionaler Zeiger auf eine Rückrufroutine, die aufgerufen werden soll, wenn eine Änderung in einem Unterverzeichnis auftritt, das in einer Verzeichnisstruktur überwacht wird. Auf diese Weise kann das Dateisystem überprüfen, ob der Watcher Zugriff auf dieses Verzeichnis hat. Eine solche vom Anrufer bereitgestellte Routine wird wie folgt deklariert:

NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID TargetContext,                     // Context pointer
    IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
    );

Weitere Informationen zum parameter TargetContext finden Sie im TargetContext- Parameter von FsRtlNotifyFullReportChange. TraverseCallback- wird ignoriert, wenn NotifyIrp NULL ist.

[in, optional] SubjectContext

Ein Zeiger auf eine SECURITY_SUBJECT_CONTEXT Struktur, die an TraverseCallback-übergeben werden soll. FsRtlNotifyFullChangeDirectory den Kontext freigibt und die Struktur nach der Verwendung freigibt. Wird ignoriert, wenn NotifyIrp- NULL ist. Wenn eine TraverseCallback- Routine bereitgestellt wird, wird SubjectContext- als SubjectContext Parameter an diese Routine übergeben.

Rückgabewert

Nichts

Bemerkungen

FsRtlNotifyFullChangeDirectory wird von einem Dateisystem aufgerufen, das eine Benachrichtigungsänderungsanforderung erhalten hat. Diese Anforderung wird als IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL, Nebenfunktionscode IRP_MN_NOTIFY_CHANGE_DIRECTORY empfangen.

Wenn NotifyIrp- NULL ist, überprüft FsRtlNotifyFullChangeDirectory, ob die Benachrichtigungsliste ein ausstehendes IRP enthält, das auf dieses Dateiobjekt verweist und in diesem Fall mit STATUS_DELETE_PENDING abgeschlossen wird.

Wenn NotifyIrp- nicht NULL ist, führt FsRtlNotifyFullChangeDirectory folgendes aus:

• Überprüft, ob das Dateiobjekt die Bereinigung durchlaufen hat. Wenn dies der Fall ist, schließt FsRtlNotifyFullChangeDirectory die Benachrichtigungs-IRP mit status STATUS_NOTIFY_CLEANUP ab.

• Wenn das Dateiobjekt keine Bereinigung durchlaufen hat, überprüft FsRtlNotifyFullChangeDirectory, ob die Benachrichtigungsliste für dieses Volume bereits eine Benachrichtigungsstruktur für diese Änderung enthält. In diesem Fall FsRtlNotifyFullChangeDirectory alle ausstehenden IRPs abgeschlossen. Andernfalls wird FsRtlNotifyFullChangeDirectory die Benachrichtigungs-IRP als ausstehend markiert, eine Benachrichtigungsstruktur erstellt und in die Liste eingefügt.

Anforderungen

Siehe auch

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT