다음을 통해 공유


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

요구 사항

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

참고 항목

BackupRead

BackupWrite

CreateFile