Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
La función SetTapePosition establece la posición de cinta en el dispositivo especificado.
Sintaxis
DWORD SetTapePosition(
[in] HANDLE hDevice,
[in] DWORD dwPositionMethod,
[in] DWORD dwPartition,
[in] DWORD dwOffsetLow,
[in] DWORD dwOffsetHigh,
[in] BOOL bImmediate
);
Parámetros
[in] hDevice
Controla el dispositivo en el que se va a establecer la posición de la cinta. Este identificador se crea mediante la función CreateFile .
[in] dwPositionMethod
Tipo de posicionamiento que se va a realizar. Este parámetro puede ser uno de los siguientes valores.
[in] dwPartition
Partición en la que se va a colocar. Si dwPartition es cero, se usa la partición actual. Las particiones se numeran lógicamente de 1 a n, donde 1 es la primera partición de la cinta y n es la última.
[in] dwOffsetLow
Bits de orden bajo de la dirección de bloque o recuento de la operación de posición especificada por el parámetro dwPositionMethod .
[in] dwOffsetHigh
Bits de orden superior de la dirección de bloque o recuento de la operación de posición especificada por el parámetro dwPositionMethod . Si no se requieren los bits de orden superior, este parámetro debe ser cero.
[in] bImmediate
Indica si se va a devolver en cuanto comienza la operación de movimiento. Si este parámetro es TRUE, la función devuelve inmediatamente; si es FALSE, la función no devuelve hasta que se haya completado la operación de movimiento.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, puede devolver uno de los siguientes códigos de error.
| Error | Descripción |
|---|---|
|
Error al intentar acceder a los datos antes del marcador inicial de medio. |
|
Se detectó una condición de restablecimiento en el bus. |
|
No se encontró la información de partición cuando se cargaba una cinta. |
|
El marcador de fin de cinta se alcanzó durante una operación. |
|
Se alcanzó una marca de archivo durante una operación. |
|
El tamaño del bloque es incorrecto en una nueva cinta en una partición multivolumen. |
|
La cinta que estaba en la unidad se ha reemplazado o quitado. |
|
Se alcanzó el marcador de fin de datos durante una operación. |
|
No hay ningún medio en la unidad. |
|
El controlador de cinta no admite una función solicitada. |
|
No se pudo crear particiones en la cinta. |
|
Se alcanzó una marca de establecimiento durante una operación. |
|
Error al intentar bloquear el mecanismo de expulsión. |
|
Error al intentar descargar la cinta. |
|
El medio está protegido contra escritura. |
Comentarios
Si el desplazamiento especificado por dwOffsetLow y dwOffsetHigh especifica el número de bloques, marcas de archivo o marcas de establecimiento que se van a mover, un desplazamiento positivo mueve la cinta hacia delante al final del último bloque, marca de archivo o marca de establecimiento. Un desplazamiento negativo mueve la cinta hacia atrás al principio del último bloque, marca de archivo o marca de establecimiento. Si el desplazamiento es cero, la cinta no se mueve.
Para obtener información sobre el estado, las funcionalidades y las capacidades de las unidades de cinta y los medios, llame a la función GetTapeParameters .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |