L_StopFeedLoad

#include "l_bitmap.h"

L_LTFIL_API L_INT L_StopFeedLoad(hLoad)

L_HGLOBAL hLoad;

/* handle that identifies the loading process */

Ends a file-load process in which you control the input stream. This cleans up all the variables and buffers allocated by the L_StartFeedLoad and L_FeedLoad functions and resets all internal variables to their default settings.

Parameter	Description
hLoad	Handle that identifies the loading process. It is the same handle that you specify in the L_StartFeedLoad function.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

You must call this function to complete a file load that was started with L_StartFeedLoad. If you call this function before supplying the complete file, it will successfully clean up the process, but will return a file-read error. You should trap the error if the load is canceled purposely.

For a description of how the functions relate to each other, refer to L_StartFeedLoad.

This function cannot be used in combination with L_RedirectIO.

Required DLLs and Libraries

LTFIL
File format DLLs

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista, Windows CE.

See Also

Functions:	L_StartFeedLoad, L_FeedLoad, L_ChangeBitmapHeight
Topics:	Raster Image Functions: Loading Files
	Raster Image Functions: Redirecting Input and Output
	Raster Image Functions: Input and Output
	Loading and Saving Images

Example

For a short example, refer to L_StartFeedLoad. For complete sample code, refer to the FEEDLOAD example