mmioSeek-Funktion (mmiscapi.h)

Artikel
08/24/2023

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

Freigeben über