_llseek-Funktion (winbase.h)
[Diese Funktion wird zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Neue Anwendungen sollten die SetFilePointer-Funktion verwenden.]
Positioniert den Dateizeiger für die angegebene Datei neu.
LONG _llseek(
HFILE hFile,
LONG lOffset,
int iOrigin
);
hFile
Ein Handle für eine geöffnete Datei. Dieses Handle wird von _lcreat erstellt.
lOffset
Die Anzahl der Bytes, die der Dateizeiger verschoben werden soll.
iOrigin
Der Startpunkt und die Richtung, in die der Zeiger verschoben wird.
Dieser Parameter muss auf einen der folgenden Werte festgelegt werden.
Wert | Bedeutung |
---|---|
|
Verschiebt den Zeiger vom Anfang der Datei. |
|
Verschiebt die Datei vom aktuellen Speicherort. |
|
Verschiebt den Zeiger vom Ende der Datei. |
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert den neuen Offset an. Andernfalls wird der Rückgabewert HFILE_ERROR. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.
Wenn eine Datei zuerst geöffnet wird, wird der Dateizeiger auf den Anfang der Datei festgelegt. Die _llseek-Funktion verschiebt den Zeiger, ohne Daten zu lesen, was den zufälligen Zugriff auf den Inhalt der Datei ermöglicht.
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | winbase.h (einschließlich Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |