Uninitialized State

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The Uninitialized state is the initial state form objects should be in when they are first created. Form objects become initialized with message data when a client application calls the IPersistMessage::InitNew or IPersistMessage::Load method on the form object. The following table describes allowed transitions from the Unitialized state.

IPersistMessage method

Action

New state

IPersistMessage::InitNew

Load the form object with default data.

Normal

IPersistMessage::Load

Load the form object with data from the target message.

Normal

IPersistMessage::GetClassID

Return success, or set the last error to and return E_UNEXPECTED.

Uninitialized

IPersistMessage::GetLastError

Return the last error.

Uninitialized

Other IPersistMessage : IUnknown methods or methods from other interfaces

Set the last error to and return E_UNEXPECTED.

Uninitialized

See Also

Concepts

Normal State

Form States