Функция PrepareTape (winbase.h)
Функция PrepareTape подготавливает ленту к доступу или удалению.
DWORD PrepareTape(
[in] HANDLE hDevice,
[in] DWORD dwOperation,
[in] BOOL bImmediate
);
[in] hDevice
Дескриптор на устройство готовит ленту. Этот дескриптор создается с помощью функции CreateFile .
[in] dwOperation
Подготовка ленточного устройства. Этот параметр может принимать одно из указанных ниже значений.
[in] bImmediate
Если этот параметр имеет значение TRUE, функция возвращает немедленно. Если значение равно FALSE, функция не возвращается, пока операция не будет завершена.
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, она может вернуть один из следующих кодов ошибок.
Ошибка | Описание |
---|---|
|
Попытка получить доступ к данным до начала среднего маркера завершилась сбоем. |
|
В шине обнаружено условие сброса. |
|
Не удалось найти сведения о секции при загрузке ленты. |
|
Маркер окончания ленты был достигнут во время операции. |
|
Метка файла была достигнута во время операции. |
|
Неправильный размер блока на новой ленте в многотомном разделе. |
|
Лента, которая находилась в диске, была заменена или удалена. |
|
Маркер конца данных был достигнут во время операции. |
|
В диске нет носителей. |
|
Драйвер ленты не поддерживает запрошенную функцию. |
|
Не удалось секционировать ленту. |
|
Метка была достигнута во время операции. |
|
Не удалось заблокировать механизм выброса. |
|
Попытка выгрузить ленту завершилась сбоем. |
|
Носитель защищен от записи. |
Некоторые ленточные устройства не поддерживают определенные операции с лентой. Ознакомьтесь с документацией по ленточным устройствам и используйте функцию GetTapeParameters , чтобы определить возможности ленточного устройства.
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | winbase.h (включая Windows.h) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |