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.