FSCTL_GET_REPARSE_POINT 제어 코드

아티클
08/08/2022
읽는 데 3분 걸림

FSCTL_GET_REPARSE_POINT 제어 코드는 지정된 파일 또는 디렉터리에 연결된 재문 분석 지점 데이터를 검색합니다.

이 작업을 수행하려면 다음 매개 변수를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.

재문 분석 지점 및 FSCTL_GET_REPARSE_POINT 제어 코드에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

매개 변수

FileObject
FltFsControlFile 만 해당됩니다. 재문 분석 지점 데이터를 검색할 파일 또는 디렉터리에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

FileHandle
ZwFsControlFile만 해당됩니다 . 재문 분석 지점 데이터를 검색할 파일 또는 디렉터리에 대한 파일 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

FsControlCode
작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_GET_REPARSE_POINT 사용합니다.

InputBuffer
이 작업에는 사용되지 않습니다. NULL로 설정됩니다.

InputBufferLength
이 작업에는 사용되지 않습니다. 0으로 설정됩니다.

OutputBuffer
재분석 지점 데이터를 수신하는 호출자가 할당한 REPARSE_GUID_DATA_BUFFER 또는 REPARSE_DATA_BUFFER 구조체에 대한 포인터입니다.

OutputBufferLength
OutputBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다. 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 구조체의 고정 부분을 포함할 수 있을 만큼 큽니다. 이 경우 재분석 지점 데이터의 고정 부분만 OutputBuffer 버퍼에 반환됩니다. LengthReturned 매개 변수를 FltFsControlFile에 반환된 데이터의 실제 길이(바이트)를 받습니다. 경고 코드입니다.
STATUS_BUFFER_TOO_SMALL	OutputBuffer 매개 변수가 가리키는 버퍼는 재문 분석 지점 데이터를 저장할 만큼 크지 않습니다. LengthReturned 매개 변수를 FltFsControlFile(또는 ZwFsControlFile에 대한 IoStatus 매개 변수의 정보 멤버)은 필요한 버퍼 크기를 받습니다. 이 경우 재문 분석 지점 데이터가 반환되지 않습니다. 오류 코드입니다.
STATUS_IO_REPARSE_DATA_INVALID	지정한 매개 변수 값 중 하나가 잘못되었습니다. 오류 코드입니다.
STATUS_NOT_A_REPARSE_POINT	파일 또는 디렉터리가 재문 분석 지점이 아닙니다. 오류 코드입니다.