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]: 이 작업에 사용되지 않습니다. 를 0으로 설정합니다.
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 버퍼에 반환됩니다. LengthReturned 매개 변수를 FltFsControlFile으로 설정하면 반환된 데이터의 실제 길이(바이트)가 수신됩니다. 경고 코드입니다.
STATUS_BUFFER_TOO_SMALL	OutputBuffer가 가리키는 버퍼는 보다 `sizeof(REPARSE_GUID_DATA_BUFFER)` 작으며 재분석 지점 데이터를 저장할 만큼 크지 않습니다. LengthReturned 매개 변수를 FltFsControlFile(또는 ZwFsControlFile에 대한 IoStatus 매개 변수의 정보 멤버)은 필요한 버퍼 크기를 받습니다. 이 경우 재분석 지점 데이터가 반환되지 않습니다. 오류 코드입니다.
STATUS_IO_REPARSE_DATA_INVALID	지정된 매개 변수 값 중 하나가 잘못되었습니다. 오류 코드입니다.
STATUS_NOT_A_REPARSE_POINT	파일 또는 디렉터리가 재분석 지점이 아닙니다. 오류 코드입니다.