get_AllChangesAreVirtual

Description

Retrieves a value that indicates whether the packed executable stores all changes made to the file system and the registry within the virtual environment instead of the real system.

If the function returns VARIANT_TRUE, all file and registry modifications are virtualized and isolated from the host operating system.

Syntax

HRESULT get_AllChangesAreVirtual([out, retval] VARIANT_BOOL* pbValue);

Parameters

pbValue
Type: VARIANT_BOOL*
[out, retval] Receives VARIANT_TRUE if all changes to the file system and registry are redirected to the virtual environment. Otherwise, receives VARIANT_FALSE.

Return Value

Returns an HRESULT.

  • S_OK if the value was successfully retrieved.
  • E_POINTER if pbValue is null.
  • Other standard COM error codes on failure.

Example

CComPtr<IBxProject> project;
if (SUCCEEDED(BxPackerApi_CreateProject(&project))) {
    VARIANT_BOOL bVirtual = VARIANT_FALSE;
    if (SUCCEEDED(project->get_AllChangesAreVirtual(&bVirtual))) {
        wprintf(L"All changes are virtual: %s\n", bVirtual == VARIANT_TRUE ? L"Enabled" : L"Disabled");
    }
}

Remarks

  • When this setting is enabled, all file system and registry modifications made by the packed executable occur only inside the virtual environment created by BoxedApp.
  • This ensures the host system remains unchanged while the application runs.
  • Disabling this feature makes the packed application interact directly with the real system environment.
  • You can modify this setting using put_AllChangesAreVirtual.

See Also