FSCTL_DELETE_REPARSE_POINT-Steuerelementcode

Artikel
03/14/2023

Der FSCTL_DELETE_REPARSE_POINT Kontrollcode löscht einen Analysepunkt aus der angegebenen Datei oder dem angegebenen Verzeichnis. Die Verwendung von FSCTL_DELETE_REPARSE_POINT löscht die Datei oder das Verzeichnis nicht.

Um diesen Vorgang auszuführen, rufen Sie ZwFsControlFile mit den folgenden Parametern auf.

Minifilter sollten FltUntagFile anstelle von FSCTL_DELETE_REPARSE_POINT verwenden, um einen Analysepunkt zu löschen.

Weitere Informationen zu Analysepunkten und dem FSCTL_DELETE_REPARSE_POINT-Steuerungscode finden Sie in der Microsoft Windows SDK-Dokumentation.

Parameter

FileHandle [in]: Dateihandle für die Datei oder das Verzeichnis, aus der bzw. dem der Analysepunkt gelöscht werden soll. Der Aufrufer muss über Schreibzugriff auf die Datei oder das Verzeichnis verfügen. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Steuerungscode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_DELETE_REPARSE_POINT.
InputBuffer [in]: Zeiger auf eine REPARSE_GUID_DATA_BUFFER- oder REPARSE_DATA_BUFFER-Struktur . Das im ReparseTag-Member dieser Struktur angegebene Tag muss mit dem Tag des zu löschenden Analysepunkts übereinstimmen, und das ReparseDataLength-Element muss null sein. Wenn es sich bei dem Analysepunkt um einen Analysepunkt eines Drittanbieters (nicht von Microsoft) handelt, muss die GUID, die im ReparseGuid-Member der REPARSE_GUID_DATA_BUFFER-Struktur angegeben ist, mit der GUID des zu löschenden Analysepunkts übereinstimmen.
InputBufferLength [in]: Größe des Puffers, auf den der InputBuffer-Parameter verweist, in Bytes. Für eine REPARSE_GUID_DATA_BUFFER-Struktur muss dieser Wert genau REPARSE_GUID_DATA_BUFFER_HEADER_SIZE sein. Für eine REPARSE_DATA_BUFFER-Struktur muss dieser Wert genau REPARSE_DATA_BUFFER_HEADER_SIZE sein.
OutputBuffer [out]: None. Auf NULL festgelegt.
OutputBufferLength [out]: Auf 0 festgelegt.

Statusblock

ZwFsControlFile gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Code	Bedeutung
STATUS_IO_REPARSE_DATA_INVALID	Einer der angegebenen Parameterwerte war ungültig. Dies ist ein Fehlercode.
STATUS_IO_REPARSE_TAG_INVALID	Das vom Aufrufer angegebene Analysetag war ungültig. Dies ist ein Fehlercode.
STATUS_IO_REPARSE_TAG_MISMATCH	Das vom Aufrufer angegebene Analysetag stimmte nicht mit dem Tag des zu löschenden Analysepunkts überein. Dies ist ein Fehlercode.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Der Analysepunkt ist ein Analysepunkt eines Drittanbieters, und die vom Aufrufer angegebene Analyse-GUID stimmte nicht mit der GUID des zu löschenden Analysepunkts überein. Dies ist ein Fehlercode.