In a multi-user implementation, the object may change as you are working on it. Call this method to ensure that you are seeing the latest state of the object.

For performance reasons, some object properties might be cached in the object itself. This method ensures that cached properties are re-read from the database.

Return codes:

• S_OK: The method successfully executed.
• S_EDM_DATABASE_ACCESS: General error accessing the database.