FSCTL_SET_REPARSE_POINT_EX Steuerungscode

Der FSCTL_SET_REPARSE_POINT_EX-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_EX verwenden, um einen Analysepunkt festzulegen.

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

Parameter

FileHandle: Dateihandle für die Datei oder das Verzeichnis, für das ein Analysepunkt festgelegt werden soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode: Steuerungscode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SET_REPARSE_POINT_EX.
InputBuffer: Zeiger auf eine vom Aufrufer zugewiesene REPARSE_GUID_DATA_BUFFER - oder REPARSE_DATA_BUFFER_EX-Struktur , die die Analysepunktdaten enthält.
InputBufferLength: 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 die Größe der benutzerdefinierten Daten sein und kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein. Für eine REPARSE_DATA_BUFFER_EX-Struktur muss dieser Wert mindestens REPARSE_DATA_BUFFER_HEADER_SIZE plus die Größe der benutzerdefinierten Daten sein und kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein.
OutputBuffer: Wird bei diesem Vorgang nicht verwendet; auf NULL festgelegt.
OutputBufferLength: Bei diesem Vorgang nicht verwendet; auf 0 festgelegt.

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

Wert	BESCHREIBUNG
STATUS_DIRECTORY_NOT_EMPTY	Ein Analysepunkt kann nicht für ein nicht erlösendes Verzeichnis festgelegt werden. Dies ist ein Fehlercode.
STATUS_EAS_NOT_SUPPORTED	Wenn sich diese Anforderung in einer Transaktion befindet, kann kein Analysepunkt für eine Datei festgelegt werden. 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 Reparse-Tag 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.