CeStreamSaveChanges (EDB)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function commits changes to a stream made with the CeStreamWrite (EDB) function.

Syntax

BOOL CeStreamSaveChanges(
  HANDLE hStream
);

Parameters

  • hStream
    [in] Handle to the stream object. The handle is obtained with the CeOpenStream (EDB) function.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. The following table shows possible values.

Return Value Description

ERROR_ACCESS_DENIED

The stream was not opened with GENERIC_WRITE.

ERROR_INVALID_HANDLE

The hStream parameter is set to NULL or equal to INVALID_HANDLE_VALUE.

ERROR_NO_MORE_ITEMS

The database from which the stream object was opened had its current seek position changed. To prevent this, open a stream, perform the operations, and then close the stream before doing anything else in the parent database.

Remarks

Once the changes to the stream are successfully committed, the stream becomes read-only. If you try to call CeStreamWrite again on the stream handle, it fails, and GetLastError returns ERROR_ACCESS_DENIED.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

EDB Functions
CeStreamWrite (EDB)
CeOpenStream (EDB)