Support::ManageSystemState method

Retrieves a SystemState interface that is bound to a file use to save and restore the system configuration.

Syntax

virtual HRESULT ManageSystemState(
  [in]  LPCWSTR     fileName,
  [out] SystemState **state
) = 0;

Parameters

fileName [in]

The name of the file used to save system settings modified through a call to SetBoolean.

state [out]

A double pointer to receive the object that implements the SystemState interface.

Return value

If the function succeeds, it returns S_OK. If it fails, it returns an error value.

Remarks

The SystemSetting enumeration defines items on a system that may be used by assessments. These settings can be read and modified. The original values of modified settings are saved in the fileName file. The system state can be restored by calling RestoreAll to reverse any configuration changes made through SetBoolean. Any changes made by manually modifying underlying OS structures are not stored. This method binds the SystemState interface to a specific filename where the modified settings will be stored.

Managed code uses the Support.ManageSystemState method.

Requirements

See also

Support