Share via

BackupSeek-Funktion (winbase.h)

  • Artikel

Die BackupSeek-Funktion sucht in einem Datenstrom, auf den zuerst mithilfe der BackupRead- oder BackupWrite-Funktion zugegriffen wird.

Syntax

BOOL BackupSeek(
  [in]  HANDLE  hFile,
  [in]  DWORD   dwLowBytesToSeek,
  [in]  DWORD   dwHighBytesToSeek,
  [out] LPDWORD lpdwLowByteSeeked,
  [out] LPDWORD lpdwHighByteSeeked,
  [in]  LPVOID  *lpContext
);

Parameter

[in] hFile

Behandeln Sie die Datei oder das Verzeichnis. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

Das Handle muss synchron (nicht überlappt) sein. Dies bedeutet, dass das FILE_FLAG_OVERLAPPED-Flag nicht festgelegt werden darf, wenn CreateFile aufgerufen wird. Diese Funktion überprüft nicht, ob das empfangene Handle synchron ist, sodass kein Fehlercode für ein synchrones Handle zurückgegeben wird, aber das Aufrufen mit einem asynchronen (überlappenden) Handle kann zu subtilen Fehlern führen, die sehr schwierig zu debuggen sind.

[in] dwLowBytesToSeek

Niedriger Teil der Anzahl der zu suchenden Bytes.

[in] dwHighBytesToSeek

Hochgeordneter Teil der Anzahl von Bytes, die gesucht werden sollen.

[out] lpdwLowByteSeeked

Zeiger auf eine Variable, die die Bits in niedriger Reihenfolge der Anzahl von Bytes empfängt, die die Funktion tatsächlich sucht.

[out] lpdwHighByteSeeked

Zeiger auf eine Variable, die die hohen Bits der Anzahl von Bytes empfängt, die die Funktion tatsächlich sucht.

[in] lpContext

Zeiger auf eine interne Datenstruktur, die von der Funktion verwendet wird. Diese Struktur muss dieselbe Struktur sein, die von der BackupRead- oder BackupWrite-Funktion initialisiert wurde. Eine Anwendung darf den Inhalt dieser Struktur nicht berühren.

Rückgabewert

Wenn die Funktion den angeforderten Betrag abrufen könnte, gibt die Funktion einen wert ohne Zero zurück.

Wenn die Funktion den angeforderten Betrag nicht abrufen konnte, gibt die Funktion null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Anwendungen verwenden die BackupSeek-Funktion , um Teile eines Datenstroms zu überspringen, die Fehler verursachen. Diese Funktion sucht nicht über Streamheader hinweg. Beispielsweise kann diese Funktion nicht verwendet werden, um den Streamnamen zu überspringen. Wenn eine Anwendung versucht, nach dem Ende eines Substreams zu suchen, schlägt die Funktion fehl, die Parameter lpdwLowByteSeeked und lpdwHighByteSeeked geben die tatsächliche Anzahl von Bytes an, die die Funktion sucht, und die Dateiposition wird am Anfang des nächsten Streamheaders platziert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

BackupRead

BackupWrite

CreateFile