Freigeben über


CFile::Seek

Ordnet den Dateizeiger in einer geöffneten Datei neu.

virtual ULONGLONG Seek(
   LONGLONG lOff,
   UINT nFrom 
);

Parameter

  • lOff
    Anzahl Bytes, um des Dateizeigers zu verschieben.Positive Werte verschieben den Dateizeiger gegen Ende der Datei; negative Werte verschieben den Dateizeiger in Bezug auf den Anfang der Datei.

  • nFrom
    Position, von zu suchen.Weitere Informationen finden Sie in den Hinweisen für mögliche Werte.

Rückgabewert

Die Position des Dateizeigers, wenn die Methode erfolgreich war; andernfalls wird der Rückgabewert undefiniert und ein Zeiger auf eine CFileException Ausnahme wird ausgelöst.

Hinweise

In der folgenden Tabelle sind mögliche Werte für den nFrom-Parameter auf.

Wert

Description

CFile::begin

Suche vom Anfang der Datei.

CFile::current

Suche von der aktuellen Position des Dateizeigers.

CFile::end

Suche vom Ende der Datei.

Wenn eine Datei geöffnet, wird der Dateizeiger bei 0, der Anfang der Datei positioniert.

Sie können den Dateizeiger an eine Position über dem Ende einer Datei hinaus festlegen.Wenn Sie dies tun, wächst die Größe der Datei nicht, bis Sie zur Datei schreiben.

Der Ausnahmehandler für diese Methode muss das Ausnahmeobjekt löschen, nachdem die Ausnahme verarbeitet ist.

Beispiel

CFile cfile;
cfile.Open(_T("Seek_File.dat"), CFile::modeCreate |
   CFile::modeReadWrite);
LONGLONG lOffset = 1000;
ULONGLONG lActual;
lActual = cfile.Seek(lOffset, CFile::begin);

Anforderungen

Header: afx.h

Siehe auch

Referenz

Die C-Datei Klasse

Hierarchien-Diagramm