Compartir a través de

Función LZSeek (lzexpand.h)

  • Artículo

Mueve un puntero de archivo al número especificado de bytes desde una posición inicial.

Sintaxis

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Parámetros

[in] hFile

Identificador del archivo.

[in] lOffset

Número de bytes por el que se va a mover el puntero de archivo.

[in] iOrigin

Posición inicial del puntero. Este parámetro puede ser uno de los siguientes valores.

Value Significado
0
 Mueve los bytes lOffset del puntero de archivo desde el principio del archivo.
1
 Mueve el puntero de archivo lOffset bytes de la posición actual.
2
 Mueve el puntero de archivo lOffset bytes desde el final del archivo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el desplazamiento desde el principio del archivo hasta la nueva posición del puntero.

Si se produce un error en la función, el valor devuelto es un código LZERROR_*. Estos códigos tienen valores inferiores a cero. Tenga en cuenta que LZSeek no llama a SetLastError ni a SetLastErrorEx; por lo tanto, su error no afecta al código de último error de un subproceso.

A continuación se muestra la lista de códigos de error que LZSeek puede devolver tras un error.

Código devuelto Descripción
LZERROR_BADINHANDLE
 El identificador que identifica el archivo de origen no es válido. No se puede leer el archivo.
LZERROR_BADVALUE
 Uno de los parámetros está fuera del intervalo de valores aceptables.
LZERROR_GLOBLOCK
 El identificador de archivo LZ no se puede bloquear.
 

No hay información de error extendida para esta función; no llame a GetLastError.

Comentarios

El identificador identificado por el parámetro hFile debe recuperarse llamando a la función LZInit o LZOpenFile .

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 Sí
Conmutación por error transparente (TFO) de SMB 3.0 Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) Sí
 

CsvFs realizará la E/S redirigida para los archivos comprimidos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado lzexpand.h (incluya Windows.h)
Library Lz32.lib
Archivo DLL Lz32.dll

Consulte también

Compresión y descompresión de archivos

Funciones de administración de archivos

LZInit

LZOpenFile