FSCTL_GET_REPARSE_POINT控件程式代碼

FSCTL_GET_REPARSE_POINT控件程式代碼會擷取與指定檔案或目錄相關聯的重新分析點數據。

若要執行這項作業，請使用下列參數呼叫 FltFsControlFile 或 ZwFsControlFile 。

如需重新分析點和FSCTL_GET_REPARSE_POINT控件程式代碼的詳細資訊，請參閱 Microsoft Windows SDK 檔。

參數

FileObject [in]： 僅限 FltFsControlFile 。要從中擷取重新分析點數據的檔案或目錄的檔案物件指標。這個參數是必要的，而且不能是 NULL。
FileHandle [in]： 僅限 ZwFsControlFile 。要從中擷取重新分析點數據的檔案或目錄的檔案句柄。這個參數是必要的，而且不能是 NULL。
FsControlCode [in]：作業的控制程序代碼。針對此作業使用 FSCTL_GET_REPARSE_POINT 。
InputBuffer [in]：未搭配此作業使用;設定為 NULL。
InputBufferLength [in]：未搭配此作業使用;設定為零。
OutputBuffer [out]：接收重新分析點數據的呼叫端配置 REPARSE_GUID_DATA_BUFFER 或 REPARSE_DATA_BUFFER 結構的指標。

OutputBufferLength [out]： OutputBuffer 參數所指向緩衝區的大小，以位元組為單位。位元組數目的計算方式如下：

結構	OutputBufferLength
REPARSE_GUID_DATA_BUFFER	必須至少REPARSE_GUID_DATA_BUFFER_HEADER_SIZE加上預期使用者定義數據的大小;和必須小於或等於MAXIMUM_REPARSE_DATA_BUFFER_SIZE。
REPARSE_DATA_BUFFER	必須至少REPARSE_DATA_BUFFER_HEADER_SIZE加上預期使用者定義數據的大小;和必須小於或等於MAXIMUM_REPARSE_DATA_BUFFER_SIZE。

FltFsControlFile 或 ZwFsControlFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

程式碼	意義
STATUS_BUFFER_OVERFLOW	OutputBuffer 參數指向的緩衝區夠大，足以保存REPARSE_GUID_DATA_BUFFER或REPARSE_DATA_BUFFER結構的固定部分，但不是使用者定義的數據。在此情況下， OutputBufferLength 位元組只會在 OutputBuffer 緩衝區中傳回。 FltFsControlFile 的 LengthReturned 參數會接收傳回之數據的實際長度，以位元組為單位。這是警告碼。
STATUS_BUFFER_TOO_SMALL	OutputBuffer 指向的緩衝區小於 `sizeof(REPARSE_GUID_DATA_BUFFER)` ，而且不足以保存重新分析點數據。 FltFsControlFile 的 LengthReturned 參數 (或 IoStatus 參數的 Information 成員至 ZwFsControlFile) 接收所需的緩衝區大小。在此情況下，不會傳回任何重新分析點數據。這是錯誤碼。
STATUS_IO_REPARSE_DATA_INVALID	其中一個指定的參數值無效。這是錯誤碼。
STATUS_NOT_A_REPARSE_POINT	檔案或目錄不是重新分析點。這是錯誤碼。