Previous PageTable Of Contents../index.htmlIndexNext Page

dx_fileseek( )

Description | Cautions | Example | Errors | See Also

Name:

long dx_fileseek(handle, offset, origin)

Inputs:

int handle

  handle returned from dx_fileopen( )

 

long offset

  number of bytes from the origin

 

int origin

  initial position

Returns:

number of bytes read if success

 

-1 if failure

Category:

File Management

Top Of PageDescription

The dx_fileseek( ) function moves a file pointer associated with the file handle to a new location that is offset bytes from origin. The function returns the offset, in bytes, of the new position from the beginning of the file. See the _lseek function in the Microsoft Visual C++ Run-Time Library Reference for more information.

Top Of PageCautions

Use dx_fileseek( ) instead of _lseek to ensure the compatibility of applications with the libraries across various versions of Visual C++.

Top Of PageExample

Top Of PageErrors

If this function returns -1 to indicate failure, a system error has occurred; use dx_fileerrno( ) to obtain the system error value. Refer to the dx_fileerrno( ) function for a list of the possible system error values.

Top Of PageSee Also


Previous PageTable Of ContentsTop Of PageIndexNext Page

Click here to contact Dialogic Customer Engineering

Copyright 2002, Dialogic Corporation
All rights reserved
This page generated February, 2002