fonction mmioSeek (mmiscapi.h)

  • Article

La fonction mmioSeek modifie la position du fichier actuel dans un fichier ouvert à l’aide de la fonction mmioOpen .

Syntaxe

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

Paramètres

hmmio

Handle de fichier du fichier à rechercher.

lOffset

Décalage pour modifier la position du fichier.

iOrigin

Indicateurs indiquant comment le décalage spécifié par lOffset est interprété. Les valeurs suivantes sont définies :

Nom Description
SEEK_CUR
 Recherche lOffset octets à partir de la position du fichier actuel.
SEEK_END
 Recherche lOffset octets à partir de la fin du fichier.
SEEK_SET
 Recherche lOffset octets à partir du début du fichier.

Valeur retournée

Retourne la nouvelle position du fichier, en octets, par rapport au début du fichier. En cas d’erreur, la valeur de retour est –1.

Notes

La recherche d’un emplacement non valide dans le fichier, par exemple passé la fin du fichier, peut ne pas entraîner le retour d’une erreur par mmioSeek , mais peut entraîner l’échec des opérations d’E/S suivantes sur le fichier.

Pour localiser la fin d’un fichier, appelez mmioSeek avec lOffset défini sur zéro et iOrigin défini sur SEEK_END.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mmiscapi.h (inclure Mmiscapi.h, Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll