<!--
{
  "availability" : [
    "macOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Virtualization",
  "identifier" : "/documentation/Virtualization/VZError",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Virtualization"
    ],
    "preciseIdentifier" : "s:SC11VZErrorCodeLeV"
  },
  "title" : "VZError"
}
-->

# VZError

Errors that you might encounter when configuring or using a VM.

```
struct VZError
```

## Overview

The domain for these errors is [`VZErrorDomain`](/documentation/Virtualization/VZErrorDomain). When an error originates in a different component, the <doc://com.apple.documentation/documentation/Foundation/NSError> object contains the domain of that component.

## Topics

### Getting the error codes

[`static var internalError: VZError.Code`](/documentation/Virtualization/VZError/internalError)

An internal error occurred.

[`static var invalidVirtualMachineConfiguration: VZError.Code`](/documentation/Virtualization/VZError/invalidVirtualMachineConfiguration)

An invalid configuration error.

[`static var invalidVirtualMachineState: VZError.Code`](/documentation/Virtualization/VZError/invalidVirtualMachineState)

An invalid state error.

[`static var invalidVirtualMachineStateTransition: VZError.Code`](/documentation/Virtualization/VZError/invalidVirtualMachineStateTransition)

An invalid state transition error.

[`static var invalidDiskImage: VZError.Code`](/documentation/Virtualization/VZError/invalidDiskImage)

An invalid disk-image error.

[`static var networkError: VZError.Code`](/documentation/Virtualization/VZError/networkError)

A network error, such as a failed connection.

[`static var notSupported: VZError.Code`](/documentation/Virtualization/VZError/notSupported)

The operation isn’t supported.

[`static var outOfDiskSpace: VZError.Code`](/documentation/Virtualization/VZError/outOfDiskSpace)

The host is out of disk space.

[`static var operationCancelled: VZError.Code`](/documentation/Virtualization/VZError/operationCancelled)

The user canceled the installation of Rosetta or the app canceled the installation of a guest OS.

[`static var installationFailed: VZError.Code`](/documentation/Virtualization/VZError/installationFailed)

An error occurred during installation.

[`static var installationRequiresUpdate: VZError.Code`](/documentation/Virtualization/VZError/installationRequiresUpdate)

The framework canceled the installation because the host requires a software update in order to complete the installation.

[`static var invalidRestoreImage: VZError.Code`](/documentation/Virtualization/VZError/invalidRestoreImage)

The restore image is invalid.

[`static var invalidRestoreImageCatalog: VZError.Code`](/documentation/Virtualization/VZError/invalidRestoreImageCatalog)

The restore image catalog is invalid.

[`static var noSupportedRestoreImagesInCatalog: VZError.Code`](/documentation/Virtualization/VZError/noSupportedRestoreImagesInCatalog)

The restore image catalog has no supported restore images.

[`static var restoreImageCatalogLoadFailed: VZError.Code`](/documentation/Virtualization/VZError/restoreImageCatalogLoadFailed)

The restore image catalog failed to load.

[`static var restoreImageLoadFailed: VZError.Code`](/documentation/Virtualization/VZError/restoreImageLoadFailed)

The restore image failed to load.

[`static var restore: VZError.Code`](/documentation/Virtualization/VZError/restore)

The VM failed to restore from the save file.

[`static var save: VZError.Code`](/documentation/Virtualization/VZError/save)

The VM failed to save to the save file.

[`static var deviceAlreadyAttached: VZError.Code`](/documentation/Virtualization/VZError/deviceAlreadyAttached)

The device already has an attachment to the VM.

[`static var deviceInitializationFailure: VZError.Code`](/documentation/Virtualization/VZError/deviceInitializationFailure)

A device initialization failure.

[`static var deviceNotFound: VZError.Code`](/documentation/Virtualization/VZError/deviceNotFound)

The framework can’t find the device.

[`static var usbControllerNotFound: VZError.Code`](/documentation/Virtualization/VZError/usbControllerNotFound)

The framework can’t find the controller.

[`static var efiSecureBootEnrollmentFailed: VZError.Code`](/documentation/Virtualization/VZError/efiSecureBootEnrollmentFailed)

[`static var efiVariableInaccessible: VZError.Code`](/documentation/Virtualization/VZError/efiVariableInaccessible)

[`static var guestProvisioningInvalidFullName: VZError.Code`](/documentation/Virtualization/VZError/guestProvisioningInvalidFullName)

[`static var guestProvisioningInvalidPassword: VZError.Code`](/documentation/Virtualization/VZError/guestProvisioningInvalidPassword)

[`static var guestProvisioningInvalidUsername: VZError.Code`](/documentation/Virtualization/VZError/guestProvisioningInvalidUsername)

[`enum Code`](/documentation/Virtualization/VZError/Code)

Errors you might encounter when configuring or using a virtual machine.

[`static var errorDomain: String`](/documentation/Virtualization/VZError/errorDomain)

### Accessing the error information

[`static var virtualMachineLimitExceeded: VZError.Code`](/documentation/Virtualization/VZError/virtualMachineLimitExceeded)

Returns an error code that indicates whether the system exceeded the limit on the number of running virtual machines.

### Comparing errors

### Type properties

[`static var networkBlockDeviceDisconnected: VZError.Code`](/documentation/Virtualization/VZError/networkBlockDeviceDisconnected)

Returns a value that indicates the connection state of the network block device.

[`static var networkBlockDeviceNegotiationFailed: VZError.Code`](/documentation/Virtualization/VZError/networkBlockDeviceNegotiationFailed)

Returns a value that indicates whether the network block device negotiation failed.

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`CustomNSError`](/documentation/Foundation/CustomNSError)

[`Sendable`](/documentation/Swift/Sendable)

[`Equatable`](/documentation/Swift/Equatable)

[`Error`](/documentation/Swift/Error)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)