Funzione SetTapePosition (winbase.h)
La funzione SetTapePosition imposta la posizione del nastro sul dispositivo specificato.
Sintassi
DWORD SetTapePosition(
[in] HANDLE hDevice,
[in] DWORD dwPositionMethod,
[in] DWORD dwPartition,
[in] DWORD dwOffsetLow,
[in] DWORD dwOffsetHigh,
[in] BOOL bImmediate
);
Parametri
[in] hDevice
Gestire il dispositivo su cui impostare la posizione del nastro. Questo handle viene creato usando la funzione CreateFile .
[in] dwPositionMethod
Tipo di posizionamento da eseguire. Questo parametro deve essere uno dei valori seguenti.
[in] dwPartition
Partizionamento da posizionare all'interno. Se dwPartition è zero, viene usata la partizione corrente. Le partizioni vengono numerate logicamente da 1 a n, dove 1 è la prima partizione sul nastro e n è l'ultima.
[in] dwOffsetLow
Bit di ordine basso dell'indirizzo del blocco o del conteggio per l'operazione di posizione specificata dal parametro dwPositionMethod .
[in] dwOffsetHigh
Bit di ordine elevato dell'indirizzo del blocco o del conteggio per l'operazione di posizione specificata dal parametro dwPositionMethod . Se i bit di ordine elevato non sono necessari, questo parametro deve essere zero.
[in] bImmediate
Indica se restituire non appena inizia l'operazione di spostamento. Se questo parametro è TRUE, la funzione restituisce immediatamente; se FALSE, la funzione non restituisce fino al completamento dell'operazione di spostamento.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, può restituire uno dei codici di errore seguenti.
| Errore | Descrizione |
|---|---|
|
Tentativo di accesso ai dati prima dell'inizio del marcatore medio non riuscito. |
|
È stata rilevata una condizione di reimpostazione sul bus. |
|
Impossibile trovare le informazioni sulla partizione quando è stato caricato un nastro. |
|
Il marcatore finale del nastro è stato raggiunto durante un'operazione. |
|
Un segno di file è stato raggiunto durante un'operazione. |
|
Le dimensioni del blocco non sono corrette su un nuovo nastro in una partizione multivolume. |
|
Il nastro che era nell'unità è stato sostituito o rimosso. |
|
Il marcatore end-of-data è stato raggiunto durante un'operazione. |
|
Non sono presenti supporti nell'unità. |
|
Il driver di nastro non supporta una funzione richiesta. |
|
Impossibile partizionare il nastro. |
|
Un segno di impostazione è stato raggiunto durante un'operazione. |
|
Tentativo di bloccare il meccanismo di espulsione non riuscito. |
|
Tentativo di scaricare il nastro non riuscito. |
|
Il supporto è protetto da scrittura. |
Commenti
Se l'offset specificato da dwOffsetLow e dwOffsetHigh specifica il numero di blocchi, segni di file o segni di impostazione da spostare, un offset positivo sposta il nastro verso la fine dell'ultimo blocco, il segno di file o il segno di set. Un offset negativo sposta il nastro indietro all'inizio dell'ultimo blocco, del segno di file o del segno di set. Se l'offset è zero, il nastro non viene spostato.
Per ottenere informazioni sullo stato, le funzionalità e le capacità delle unità nastro e dei supporti, chiamare la funzione GetTapeParameters .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |