Funzione BackupSeek (winbase.h)
La funzione BackupSeek cerca di inoltrare in un flusso di dati a cui si accede inizialmente usando la funzione BackupRead o BackupWrite .
Sintassi
BOOL BackupSeek(
[in] HANDLE hFile,
[in] DWORD dwLowBytesToSeek,
[in] DWORD dwHighBytesToSeek,
[out] LPDWORD lpdwLowByteSeeked,
[out] LPDWORD lpdwHighByteSeeked,
[in] LPVOID *lpContext
);
Parametri
[in] hFile
Gestire il file o la directory. Questo handle viene creato usando la funzione CreateFile .
L'handle deve essere sincrono (non sovrapposto). Ciò significa che il flag FILE_FLAG_OVERLAPPED non deve essere impostato quando viene chiamato CreateFile . Questa funzione non convalida che l'handle che riceve è sincrono, quindi non restituisce un codice di errore per un handle sincrono, ma chiamandolo con un handle asincrono (sovrapposto) può causare errori sottili che sono molto difficili da eseguire per il debug.
[in] dwLowBytesToSeek
Parte bassa dell'ordine del numero di byte da cercare.
[in] dwHighBytesToSeek
Parte elevata del numero di byte da cercare.
[out] lpdwLowByteSeeked
Puntatore a una variabile che riceve i bit a basso ordine del numero di byte effettivamente cerca la funzione.
[out] lpdwHighByteSeeked
Puntatore a una variabile che riceve i bit di ordine elevato del numero di byte effettivamente cerca la funzione.
[in] lpContext
Puntatore a una struttura di dati interna usata dalla funzione. Questa struttura deve essere la stessa struttura inizializzata dalla funzione BackupRead o BackupWrite . Un'applicazione non deve toccare il contenuto di questa struttura.
Valore restituito
Se la funzione potrebbe cercare l'importo richiesto, la funzione restituisce un valore diverso da zero.
Se la funzione non è riuscita a cercare l'importo richiesto, la funzione restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Le applicazioni usano la funzione BackupSeek per ignorare parti di un flusso di dati che causano errori. Questa funzione non cerca tra intestazioni di flusso. Ad esempio, questa funzione non può essere usata per ignorare il nome del flusso. Se un'applicazione tenta di cercare oltre la fine di un sottostream, la funzione ha esito negativo, lpdwLowByteSeeked e lpdwHighByteSeeked indica il numero effettivo di byte che la funzione cerca e la posizione del file viene posizionata all'inizio dell'intestazione del flusso successivo.
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 |