mmioSeek-Funktion (mmiscapi.h)

  • Artikel

Die mmioSeek-Funktion ändert die aktuelle Dateiposition in einer datei, die mithilfe der funktion mmioOpen geöffnet wurde.

Syntax

LONG mmioSeek(
  HMMIO hmmio,
  LONG  lOffset,
  int   iOrigin
);

Parameter

hmmio

Dateihandle der Datei, in der gesucht werden soll.

lOffset

Offset, um die Dateiposition zu ändern.

iOrigin

Flags, die angeben, wie der von lOffset angegebene Offset interpretiert wird. Die folgenden Werte werden definiert:

Name BESCHREIBUNG
SEEK_CUR
 Sucht nach lOffset-Bytes aus der aktuellen Dateiposition.
SEEK_END
 Sucht nach lOffset-Bytes vom Ende der Datei.
SEEK_SET
 Sucht nach lOffset-Bytes vom Anfang der Datei.

Rückgabewert

Gibt die neue Dateiposition in Bytes relativ zum Anfang der Datei zurück. Wenn ein Fehler auftritt, ist der Rückgabewert –1.

Hinweise

Wenn Sie einen ungültigen Speicherort in der Datei suchen, z. B. nach dem Ende der Datei, führt dies möglicherweise nicht dazu, dass mmioSeek einen Fehler zurückgibt, aber es kann dazu führen, dass nachfolgende E/A-Vorgänge für die Datei fehlschlagen.

Um das Ende einer Datei zu suchen, rufen Sie mmioSeek auf, wobei lOffset auf null und iOrigin auf SEEK_END festgelegt ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmiscapi.h (einschließlich Mmiscapi.h, Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll