IMailUser::SaveChanges


		Contents Index Topic Contents
	Previous Topic: IMailUser::OpenProperty Next Topic: IMailUser::SetProps

IMailUser::SaveChanges
HRESULT SaveChanges(
    ULONG  ulFlags
);
Saves changes to the open mail user object. Note that the following properties may be calculated and changed at SaveChanges:

PR_DISPLAY_NAME
PR_GIVEN_NAME
PR_SURNAME
PR_LAST_MODIFICATION_TIME

Returns one of the following values:

S_OK The commitment of changes has been successful.

MAPI_E_NO_ACCESS SaveChanges cannot keep the object open for read-only access if KEEP_OPEN_READONLY is set, or read/write access if KEEP_OPEN_READWRITE is set. No changes are committed.

MAPI_E_OBJECT_CHANGED The object has changed since it was opened.

MAPI_E_OBJECT_DELETED The object has been deleted since it was opened.

ulFlags
Bitmask of flags that control what happens to the object when the SaveChanges method is called. The following flags can be set:

FORCE_SAVE Writes changes to the object and closes it. Read-write access must have been set for the operation to succeed. This flag forces saving only if MAPI_E_OBJECT_CHANGED was returned from a preceding SaveChanges call. FORCE_SAVE overrides the previous changes made to the object.

KEEP_OPEN_READONLY Indicates the client requests changes be committed and the object be kept open for reading. This flag informs the provider that the object should not be modified and that the calling implementation will not call SaveChanges again. If the provider cannot keep the object open for read-only access, the entire call fails, changes are not saved, and MAPI_E_NO_ACCESS is returned.

KEEP_OPEN_READWRITE Indicates the client requests changes be committed and the object be kept open for read-write access. This flag is usually set when the object was initially opened for read-write access. After calling SaveChanges, the client can make further changes to the object if this flag is passed. If the provider cannot keep the object open for read-write access, the entire call fails, changes are not saved, and MAPI_E_NO_ACCESS is returned.

MAPI_DEFERRED_ERRORS Currently not supported by Internet Explorer Address Book.

Back to top

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

S_OK	The commitment of changes has been successful.
MAPI_E_NO_ACCESS	SaveChanges cannot keep the object open for read-only access if KEEP_OPEN_READONLY is set, or read/write access if KEEP_OPEN_READWRITE is set. No changes are committed.
MAPI_E_OBJECT_CHANGED	The object has changed since it was opened.
MAPI_E_OBJECT_DELETED	The object has been deleted since it was opened.

FORCE_SAVE	Writes changes to the object and closes it. Read-write access must have been set for the operation to succeed. This flag forces saving only if MAPI_E_OBJECT_CHANGED was returned from a preceding SaveChanges call. FORCE_SAVE overrides the previous changes made to the object.
KEEP_OPEN_READONLY	Indicates the client requests changes be committed and the object be kept open for reading. This flag informs the provider that the object should not be modified and that the calling implementation will not call SaveChanges again. If the provider cannot keep the object open for read-only access, the entire call fails, changes are not saved, and MAPI_E_NO_ACCESS is returned.
KEEP_OPEN_READWRITE	Indicates the client requests changes be committed and the object be kept open for read-write access. This flag is usually set when the object was initially opened for read-write access. After calling SaveChanges, the client can make further changes to the object if this flag is passed. If the provider cannot keep the object open for read-write access, the entire call fails, changes are not saved, and MAPI_E_NO_ACCESS is returned.
MAPI_DEFERRED_ERRORS	Currently not supported by Internet Explorer Address Book.