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

Vedere anche

BackupRead

BackupWrite

CreateFile