FSCTL_GET_REPARSE_POINT código de control

Artículo
06/20/2023

El código de control FSCTL_GET_REPARSE_POINT recupera los datos del punto de reanálisis asociados al archivo o directorio especificados.

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Para obtener más información sobre los puntos de reanálisis y el código de control de FSCTL_GET_REPARSE_POINT, consulte la documentación de Microsoft Windows SDK.

Parámetros

FileObject [in]: FltFsControlFile solo. Puntero de objeto de archivo para el archivo o directorio desde el que recuperar los datos del punto de reanálisis. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador de archivo para el archivo o directorio desde el que recuperar los datos del punto de reanálisis. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: código de control para la operación. Use FSCTL_GET_REPARSE_POINT para esta operación.
InputBuffer [in]: No se usa con esta operación; se establece en NULL.
InputBufferLength [in]: No se usa con esta operación; se establece en cero.
OutputBuffer [out]: puntero a una estructura de REPARSE_GUID_DATA_BUFFER asignada por el autor de la llamada o REPARSE_DATA_BUFFER que recibe los datos del punto de reanálisis.

OutputBufferLength [out]: Tamaño, en bytes, del búfer al que apunta el parámetro OutputBuffer . El número de bytes se calcula de la siguiente manera:

Estructura	OutputBufferLength
REPARSE_GUID_DATA_BUFFER	Debe ser al menos REPARSE_GUID_DATA_BUFFER_HEADER_SIZE más el tamaño de los datos definidos por el usuario esperados; y deben ser menores o iguales que MAXIMUM_REPARSE_DATA_BUFFER_SIZE.
REPARSE_DATA_BUFFER	Debe ser al menos REPARSE_DATA_BUFFER_HEADER_SIZE más el tamaño de los datos definidos por el usuario esperados; y deben ser menores o iguales que MAXIMUM_REPARSE_DATA_BUFFER_SIZE.

Bloque de estado

FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código	Significado
STATUS_BUFFER_OVERFLOW	El búfer al que apunta el parámetro OutputBuffer es lo suficientemente grande como para contener la parte fija de la estructura REPARSE_GUID_DATA_BUFFER o REPARSE_DATA_BUFFER, pero no los datos definidos por el usuario. En este caso, solo se devuelven bytes OutputBufferLength en el búfer OutputBuffer . El parámetro LengthReturned de FltFsControlFile recibe la longitud real, en bytes, de los datos devueltos. Se trata de un código de advertencia.
STATUS_BUFFER_TOO_SMALL	El búfer al que OutputBuffer apunta es menor que `sizeof(REPARSE_GUID_DATA_BUFFER)` y no es lo suficientemente grande como para contener los datos del punto de reanálisis. El parámetro LengthReturned a FltFsControlFile (o el miembro Information del parámetro IoStatus a ZwFsControlFile) recibe el tamaño de búfer necesario. En este caso, no se devuelven datos de punto de reanálisis. Se trata de un código de error.
STATUS_IO_REPARSE_DATA_INVALID	Uno de los valores de parámetro especificados no era válido. Se trata de un código de error.
STATUS_NOT_A_REPARSE_POINT	El archivo o directorio no es un punto de reanálisis. Se trata de un código de error.