FSCTL_SET_REPARSE_POINT-Steuerungscode

Artikel
02/02/2024

Der FSCTL_SET_REPARSE_POINT-Steuerelementcode legt einen Analysepunkt für eine Datei oder ein Verzeichnis fest.

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

Minifilter sollten FltTagFile anstelle von FSCTL_SET_REPARSE_POINT verwenden, um einen Analysepunkt festzulegen.

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

Parameter

FileHandle [in]: Dateihandle für die Datei oder das Verzeichnis, für die bzw. das ein Analysepunkt festgelegt werden soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Steuerungscode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SET_REPARSE_POINT.
InputBuffer [in]: Zeiger auf eine vom Aufrufer zugewiesene REPARSE_GUID_DATA_BUFFER - oder REPARSE_DATA_BUFFER-Struktur , die die Analysepunktdaten enthält. Wenn ein vorhandener Analysepunkt geändert wird, muss das im ReparseTag-Member dieser Struktur angegebene Tag mit dem Tag des zu ändernden Analysepunkts übereinstimmen. Wenn der Analysepunkt ein Analysepunkt eines Drittanbieters (nicht von Microsoft) ist, ist die im ReparseGuid-Member der Struktur angegebene GUID ein REPARSE_GUID_DATA_BUFFER Struktur mit der GUID des zu ändernden Analysepunkts übereinstimmen muss.
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 mindestens REPARSE_GUID_DATA_BUFFER_HEADER_SIZE plus der Größe der benutzerdefinierten Daten und kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein. Für eine REPARSE_DATA_BUFFER-Struktur muss dieser Wert mindestens REPARSE_DATA_BUFFER_HEADER_SIZE plus der Größe der benutzerdefinierten Daten und kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein.
OutputBuffer [out]: Bei diesem Vorgang nicht verwendet; auf NULL festgelegt.
OutputBufferLength [out]: Bei diesem Vorgang nicht verwendet; auf 0 (null) festgelegt.

Statusblock

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

Code	Bedeutung
STATUS_DIRECTORY_NOT_EMPTY	Ein Analysepunkt kann nicht für ein nicht leeres Verzeichnis festgelegt werden. Dies ist ein Fehlercode.
STATUS_EAS_NOT_SUPPORTED	Ein Analysepunkt kann nicht für eine Datei festgelegt werden, wenn sich diese Anforderung in einer Transaktion befindet. Dies ist ein Fehlercode.
STATUS_IO_REPARSE_DATA_INVALID	Einer der angegebenen Parameterwerte war ungültig. Dies ist ein Fehlercode.
STATUS_IO_REPARSE_TAG_MISMATCH	Das vom Aufrufer angegebene Analysetag stimmte nicht mit dem Tag des zu ändernden Analysepunkts überein. Dies ist ein Fehlercode.
STATUS_NOT_A_REPARSE_POINT	Die Datei oder das Verzeichnis ist kein Analysepunkt. 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 ändernden Analysepunkts überein. Dies ist ein Fehlercode.