BackupSeek-Funktion (winbase.h)
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 |