ResetOnHibernate property

The ResetOnHibernate property sets the ResetOnHibernate option. This option causes a computer to restart instead of shut down after a computer hibernates.

This property is write-only.

Syntax

HRESULT put_ResetOnHibernate(
  [in]  VARIANT_BOOL newVal
);

Property value

A new value that specifies the action to be performed when the system attempts to go into hibernate mode. If set to VARIANT_TRUE, the system restarts after it finishes the write operation to the hibernation file (Hiberfil.sys) instead of going into hibernate mode. If set to VARIANT_FALSE, the system goes into hibernate mode after it finishes the write operation to the hibernation file.

Error codes

ResetOnHibernate returns a standard HRESULT.

Remarks

The ResetOnHibernate property is used to control the action that is performed by the system when it attempts to hibernate after writing to the hibernation file. If the property is set to VARIANT_TRUE, the system finishes all pre-hibernation tasks but does not transition to the hibernate state. Instead, it restarts and performs all post-hibernation tasks while the system is starting.

The default value for this property is VARIANT_FALSE. However, when the Console::EnableAutoWakeIfPossible method is called, the ResetOnHibernate property is automatically set to VARIANT_TRUE if the system cannot be awakened from the S4 (hibernate) sleep state by the Real Time Clock (RTC). The Console::EnableAutoWakeIfPossible method is called when the Console::Sleep or Console::QuickSleep methods are called.

Note  The ResetOnHibernate property is not initialized on object construction. However, this property is reset back to its initial value on object destruction.

See also

Console

Console::EnableAutoWakeIfPossible

Console::QuickSleep

Console::Sleep

 

 

Send comments about this topic to Microsoft

Build date: 1/12/2012