CInternetFile::Seek

Rufen Sie die Memberfunktion auf, um den Zeiger in einer zuvor geöffneten Datei neu anzuordnen.

virtual ULONGLONG Seek( 
   LONGLONG lOffset, 
   UINT nFrom  
);

Parameter

• lOffset
  Entsprechung für in Bytes aus, um den Lese-Schreibzeiger in der Datei zu verschieben.

• nFrom
  Relativer Verweis während des Offsets.Muss einem der folgenden Werte:

  • CFile::begin Verschiebt den Dateizeiger lOff Bytes vorwärts vom Anfang der Datei.

  • CFile::current Verschiebt den Dateizeiger lOff Bytes von der aktuellen Position in der Datei.

  • CFile::end Verschiebt den Dateizeiger lOff Bytes vom Ende der Datei.lOff muss negativ sein, in die vorhandene Datei zu suchen; positive Werte suchen nach dem Ende der Datei.

Rückgabewert

Der neue Byteoffset vom Anfang der Datei, wenn die angeforderte Position gültig ist; andernfalls wird der Wert undefiniert und ein CInternetException-Objekt wird ausgelöst.

Hinweise

Die Seek-Funktion ermöglicht wahlfreien Zugriff auf den Inhalt einer Datei, indem Sie den Zeiger ein bestimmte Datenmenge, absolut oder relativ verschoben wird.Keine Daten werden tatsächlich während der Suche gelesen.

Derzeit wird ein Aufruf der Memberfunktion nur für die Daten unterstützt, die mit CHttpFile-Objekten zugeordnet sind.Er wird nicht für FTP oder Gopher-Anforderungen unterstützt.Wenn Sie Seek für eine dieser nicht unterstützten Dienste aufrufen, führt sie wieder Sie zum Win32-Fehlercode ERROR_INTERNET_INVALID_OPERATION.

Wenn eine Datei geöffnet ist, ist der Dateizeiger an Offset 0, der Anfang der Datei.

Hinweis
Verwenden Seek kann einen impliziten Aufruf verursachen Leeren.

Ausnahmen

Diese Methode kann Ausnahmen des Typs CInternetException* auslösen.

Beispiel

Im Beispiel für die Basisklassenimplementierung (CFile::Seek).

Anforderungen

Header: afxinet.h

Siehe auch

Referenz

CInternetFile-Klasse

Hierarchien-Diagramm