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 |
---|---|
|
Procura lOffset bytes da posição do arquivo atual. |
|
Procura lOffset bytes do final do arquivo. |
|
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 |