Função mmioSeek (mmiscapi.h)

A função mmioSeek altera a posição do arquivo atual em um arquivo aberto usando a função mmioOpen .

Sintaxe

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

Parâmetros

hmmio

Identificador de arquivo do arquivo a ser buscado.

lOffset

Deslocamento para alterar a posição do arquivo.

iOrigin

Sinalizadores que indicam como o deslocamento especificado por lOffset é interpretado. Os seguintes valores são definidos:

Nome	Descrição
SEEK_CUR	Procura lOffset bytes da posição do arquivo atual.
SEEK_END	Procura lOffset bytes do final do arquivo.
SEEK_SET	Procura lOffset bytes desde o início do arquivo.

Valor retornado

Retorna a nova posição do arquivo, em bytes, em relação ao início do arquivo. Se houver um erro, o valor retornado será –1.

Comentários

A busca de um local inválido no arquivo, como após o final do arquivo, pode não fazer com que mmioSeek retorne um erro, mas isso pode fazer com que as operações de E/S subsequentes no arquivo falhem.

Para localizar o final de um arquivo, chame mmioSeek com lOffset definido como zero e iOrigin definido como SEEK_END.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mmiscapi.h (inclua Mmiscapi.h, Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll