WriteTapemark 함수(winbase.h)
WriteTapemark 함수는 지정된 수의 파일 표시, setmarks, 짧은 파일 표시 또는 긴 파일 표시를 테이프 디바이스에 씁니다. 이러한 테이프 표시는 테이프 파티션을 더 작은 영역으로 나눕니다.
구문
DWORD WriteTapemark(
[in] HANDLE hDevice,
[in] DWORD dwTapemarkType,
[in] DWORD dwTapemarkCount,
[in] BOOL bImmediate
);
매개 변수
[in] hDevice
테이프 표시를 작성할 디바이스에 대한 핸들입니다. 이 핸들은 CreateFile 함수를 사용하여 만듭니다.
[in] dwTapemarkType
쓸 테이프 표시의 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
[in] dwTapemarkCount
쓸 테이프 표시 수입니다.
[in] bImmediate
이 매개 변수가 TRUE이면 함수가 즉시 반환됩니다. FALSE이면 작업이 완료될 때까지 함수가 반환되지 않습니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 다음 오류 코드 중 하나를 반환할 수 있습니다.
| 오류 | Description |
|---|---|
|
중간 시작 표식이 실패하기 전에 데이터에 액세스하려는 시도가 실패했습니다. |
|
버스에서 재설정 조건이 감지되었습니다. |
|
테이프를 로드할 때 파티션 정보를 찾을 수 없습니다. |
|
작업 중에 테이프 끝 마커에 도달했습니다. |
|
작업 중에 파일 표시에 도달했습니다. |
|
블록 크기가 다발성 파티션의 새 테이프에서 올바르지 않습니다. |
|
드라이브에 있던 테이프가 교체되거나 제거되었습니다. |
|
작업 중에 데이터 끝 표식에 도달했습니다. |
|
드라이브에 미디어가 없습니다. |
|
테이프 드라이버는 요청된 함수를 지원하지 않습니다. |
|
테이프를 분할할 수 없습니다. |
|
작업 중에 setmark에 도달했습니다. |
|
배출 메커니즘을 잠그지 못했습니다. |
|
테이프를 언로드하지 못했습니다. |
|
미디어가 쓰기 보호되어 있습니다. |
설명
파일 표시, 집합 표시, 짧은 파일 표시 및 긴 파일 표시는 테이프의 선형 organization 나타내는 특수하게 기록된 요소입니다. 이러한 표시에는 사용자 데이터가 포함되지 않습니다. 파일 표시는 가장 일반적인 표시입니다. setmarks는 파일 표시와 함께 사용할 수 없는 계층 구조를 제공합니다.
짧은 파일 표시에는 쓰기 작업이 파티션의 시작 부분이나 이전의 긴 파일 표시에서 수행되지 않는 한 덮어쓸 수 없는 짧은 지우기 간격이 포함됩니다.
긴 파일 표시에는 애플리케이션이 테이프를 파일 표시의 시작 부분에 배치하고 파일 표시 및 지우기 간격을 덮어쓸 수 있는 긴 지우기 간격이 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |