BackupSeek 함수(winbase.h)

BackupSeek 함수는 BackupRead 또는 BackupWrite 함수를 사용하여 처음에 액세스한 데이터 스트림에서 앞으로 찾습니다.

구문

BOOL BackupSeek(
  [in]  HANDLE  hFile,
  [in]  DWORD   dwLowBytesToSeek,
  [in]  DWORD   dwHighBytesToSeek,
  [out] LPDWORD lpdwLowByteSeeked,
  [out] LPDWORD lpdwHighByteSeeked,
  [in]  LPVOID  *lpContext
);

매개 변수

[in] hFile

파일 또는 디렉터리에 대한 핸들입니다. 이 핸들은 CreateFile 함수를 사용하여 만들어집니다.

핸들은 동기(오버랩되지 않음)여야 합니다. 즉 , CreateFile 이 호출될 때 FILE_FLAG_OVERLAPPED 플래그를 설정해서는 안 됩니다. 이 함수는 수신하는 핸들이 동기식인지 확인하지 않으므로 동기 핸들에 대한 오류 코드를 반환하지 않지만 비동기(겹침) 핸들을 사용하여 호출하면 디버그하기가 매우 어려운 미묘한 오류가 발생할 수 있습니다.

[in] dwLowBytesToSeek

검색할 바이트 수의 하위 순서 부분입니다.

[in] dwHighBytesToSeek

검색할 바이트 수의 상위 부분입니다.

[out] lpdwLowByteSeeked

함수가 실제로 찾는 바이트 수의 낮은 순서 비트를 수신하는 변수에 대한 포인터입니다.

[out] lpdwHighByteSeeked

함수가 실제로 찾는 바이트 수의 상위 비트를 수신하는 변수에 대한 포인터입니다.

[in] lpContext

함수에서 사용하는 내부 데이터 구조에 대한 포인터입니다. 이 구조체는 BackupRead 또는 BackupWrite 함수에 의해 초기화된 구조와 동일해야 합니다. 애플리케이션이 이 구조체의 내용을 터치해서는 안 됩니다.

반환 값

함수가 요청된 금액을 검색할 수 있는 경우 함수는 0이 아닌 값을 반환합니다.

함수가 요청된 금액을 검색할 수 없는 경우 함수는 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

애플리케이션은 BackupSeek 함수를 사용하여 오류를 일으키는 데이터 스트림의 일부를 건너뜁니다. 이 함수는 스트림 헤더에서 검색하지 않습니다. 예를 들어 이 함수는 스트림 이름을 건너뛰는 데 사용할 수 없습니다. 애플리케이션이 하위 스트림의 끝을 지나서 검색하려고 하면 함수가 실패하고 lpdwLowByteSeeked 및 lpdwHighByteSeeked 매개 변수는 함수가 찾는 실제 바이트 수를 나타내며 파일 위치는 다음 스트림 헤더의 시작 부분에 배치됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

BackupRead

BackupWrite

CreateFile