FSCTL_GET_REPARSE_POINT Steuerungscode

Artikel
02/02/2024

Der FSCTL_GET_REPARSE_POINT-Steuerelementcode ruft die Analysepunktdaten ab, die der angegebenen Datei oder dem angegebenen Verzeichnis zugeordnet sind.

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

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

Parameter

FileObject [in]: Nur FltFsControlFile . Dateiobjektzeiger für die Datei oder das Verzeichnis, aus dem die Analysepunktdaten abgerufen werden sollen. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: nur ZwFsControlFile . Dateihandle für die Datei oder das Verzeichnis, aus dem die Analysepunktdaten abgerufen werden sollen. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Ein Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_GET_REPARSE_POINT .
InputBuffer [in]: Nicht für diesen Vorgang verwendet; auf NULL festgelegt.
InputBufferLength [in]: Bei diesem Vorgang nicht verwendet; auf 0 festgelegt.
OutputBuffer [out]: Zeiger auf eine vom Aufrufer zugewiesene REPARSE_GUID_DATA_BUFFER oder REPARSE_DATA_BUFFER Struktur, die die Analysepunktdaten empfängt.

OutputBufferLength [out]: Größe des Puffers in Bytes, auf den der OutputBuffer-Parameter verweist. Die Anzahl der Bytes wird wie folgt berechnet:

Struktur	OutputBufferLength
REPARSE_GUID_DATA_BUFFER	Muss mindestens REPARSE_GUID_DATA_BUFFER_HEADER_SIZE plus die Größe der erwarteten benutzerdefinierten Daten sein; und muss kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein.
REPARSE_DATA_BUFFER	Muss mindestens REPARSE_DATA_BUFFER_HEADER_SIZE plus die Größe der erwarteten benutzerdefinierten Daten sein. und muss kleiner oder gleich MAXIMUM_REPARSE_DATA_BUFFER_SIZE sein.

Statusblock

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

Code	Bedeutung
STATUS_BUFFER_OVERFLOW	Der Puffer, auf den der OutputBuffer-Parameter verweist, ist groß genug, um den festen Teil der REPARSE_GUID_DATA_BUFFER- oder REPARSE_DATA_BUFFER-Struktur, aber nicht die benutzerdefinierten Daten zu enthalten. In diesem Fall werden nur OutputBufferLength-Bytes im OutputBuffer-Puffer zurückgegeben. Der LengthReturned-Parameter für FltFsControlFile empfängt die tatsächliche Länge der zurückgegebenen Daten in Bytes. Dies ist ein Warncode.
STATUS_BUFFER_TOO_SMALL	Der Puffer, auf den OutputBuffer verweist, ist kleiner als `sizeof(REPARSE_GUID_DATA_BUFFER)` und nicht groß genug, um die Analysepunktdaten aufzunehmen. Der LengthReturned-Parameter für FltFsControlFile (oder das Information-Element des IoStatus-Parameters zu ZwFsControlFile) empfängt die erforderliche Puffergröße. In diesem Fall werden keine Analysepunktdaten zurückgegeben. Dies ist ein Fehlercode.
STATUS_IO_REPARSE_DATA_INVALID	Einer der angegebenen Parameterwerte war ungültig. Dies ist ein Fehlercode.
STATUS_NOT_A_REPARSE_POINT	Die Datei oder das Verzeichnis ist kein Analysepunkt. Dies ist ein Fehlercode.