Función mmioSeek (mmiscapi.h)

La función mmioSeek cambia la posición del archivo actual en un archivo abierto mediante la función mmioOpen .

Sintaxis

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

Parámetros

hmmio

Identificador de archivo del archivo en el que se va a buscar.

lOffset

Desplazamiento para cambiar la posición del archivo.

iOrigin

Marcas que indican cómo se interpreta el desplazamiento especificado por lOffset . Se definen los siguientes valores:

Nombre	Descripción
SEEK_CUR	Busca bytes lOffset desde la posición del archivo actual.
SEEK_END	Busca bytes lOffset desde el final del archivo.
SEEK_SET	Busca bytes lOffset desde el principio del archivo.

Valor devuelto

Devuelve la nueva posición del archivo, en bytes, con respecto al principio del archivo. Si se produce un error, el valor devuelto es –1.

Comentarios

La búsqueda de una ubicación no válida en el archivo, como después del final del archivo, podría no provocar que mmioSeek devuelva un error, pero podría provocar un error en las operaciones de E/S posteriores en el archivo.

Para buscar el final de un archivo, llame a mmioSeek con lOffset establecido en cero y iOrigin establecido en SEEK_END.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mmiscapi.h (incluye Mmiscapi.h, Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll