in host/common/win32/portablehelpersmajor.cpp [5520:5737]
void FormatVacpErrorCode(std::stringstream& stream, SV_ULONG& exitCode)
{
DebugPrintf(SV_LOG_DEBUG, "ENTERED %s\n", FUNCTION_NAME);
if (exitCode != 0)
{
stream << "Vacp failed to issue the consistency. Failed with Error Code:";
switch (exitCode)
{
case VACP_E_GENERIC_ERROR: //(10001)
stream << "1 (Vacp Generic Error)";
break;
case VACP_E_INVALID_COMMAND_LINE:
stream << "10001. ( Invalid command line options specified for vacp.exe. Use Vacp -h to know more about command line options )";
break;
case VACP_E_INVOLFLT_DRIVER_NOT_INSTALLED: //(10002)
stream << "10002. (Scout Filter driver is not loaded. Ensure VX is installed and machine is rebooted)";
break;
case VACP_E_DRIVER_IN_NON_DATA_MODE: //(10003)
stream << "10003, (Some of the protected volumes are not in write order data mode. Consistency point will be tried in next scheduled interval.)";
break;
case VACP_E_NO_PROTECTED_VOLUMES: //10004
stream << "10004, (There are no protected volumes to issue consistency bookmark. If the volumes are deleted, make sure to recreate them or recover them. If not protected remove them from the vacp command line.) ";
break;
case VACP_E_NON_FIXED_DISK:
stream << "10005. ( Some or all of the Volumes are Invalid or Deleted or Unavailable volumes.)";
break;
case VACP_E_ZERO_EFFECTED_VOLUMES:
stream << "10006. ( There are zero or no affected volumes to issue a consistency tag.)";
break;
case VACP_E_VACP_SENT_REVOCATION_TAG:
stream << "10007. ( Vacp has sent a revocation tag as some or all of the participating VSS Writers are not in a Consistent State.)";
break;
case VACP_E_VACP_MODULE_FAIL:
stream << "0x80004005L. (Vacp failed for generic reasons.)";
break;
case VACP_E_PRESCRIPT_FAILED:
stream << "10009. (The pre-script invoked has failed.)";
break;
case VACP_E_POSTSCRIPT_FAILED:
stream << "10010. (The post-script invoked has failed.)";
break;
case VACP_PRESCRIPT_WAIT_TIME_EXCEEDED:
stream << "10998. (The pre-script invoked has exceeded the maximum time to finsh and hence being terminated.)";
break;
case VACP_POSTSCRIPT_WAIT_TIME_EXCEEDED:
stream << "10999. (The post-script invoked has exceeded the maximum time to finsh and hence being terminated.)";
break;
case VSS_E_BAD_STATE: stream << "0x80042301L . ( The backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence. )";
break;
case VSS_E_PROVIDER_ALREADY_REGISTERED: stream << "0x80042303L . ( Provider already registered )";
break;
case VSS_E_PROVIDER_NOT_REGISTERED: stream << "0x80042304L . ( The provider has already been registered on this computer. )";
break;
case VSS_E_PROVIDER_VETO: stream << "0x80042306L . ( An unexpected provider error occurred. If this is returned, the error must be described in an entry in the application event log, giving the user information on how to resolve the problem.)";
break;
case VSS_E_PROVIDER_IN_USE: stream << "0x80042307L . ( Provider already in use. Retry after some time )";
break;
case VSS_E_OBJECT_NOT_FOUND: stream << "0x80042308L . ( VSS object not found )";
break;
case VSS_S_ASYNC_PENDING: stream << "0x42309L . ( VSS async pending The asynchronous operation is still running.)";
break;
case VSS_S_ASYNC_FINISHED: stream << "0x4230aL . ( VSS async finished.The asynchronous operation was completed successfully. )";
break;
case VSS_S_ASYNC_CANCELLED: stream << "0x4230bL . ( VSS async cacelled.The asynchronous operation had been canceled prior to calling \"Cancel\" method. )";
break;
case VSS_E_VOLUME_NOT_SUPPORTED: stream << "0x8004230cL . ( VSS does not support issuing tag on one of the volumes.No VSS provider indicates that it supports the specified volume. )";
break;
case VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER: stream << "0x8004230eL . ( Provider does not support issuing tag on one of the volumes.The volume is not supported by the specified provider. )";
break;
case VSS_E_OBJECT_ALREADY_EXISTS: stream << "0x8004230dL . ( VSS object already exists )";
break;
case VSS_E_UNEXPECTED_PROVIDER_ERROR:
stream << "0x8004230fL . ( VSS unexpected provider error )";
break;
case VSS_E_CORRUPT_XML_DOCUMENT:
stream << "0x80042310L . ( VSS XML document corrupted. )";
break;
case VSS_E_INVALID_XML_DOCUMENT:
stream << "0x80042311L . ( invalid XML document.The given XML document is invalid. It is either incorrectly-formed XML or it does not match the schema. )";
break;
case VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED:
stream << "0x80042312L . ( The provider has reached the maximum number of volumes it can support.OR the maximum number of volumes has been added to the shadow copy set. The specified volume was not added to the shadow copy set. )";
break;
case VSS_E_FLUSH_WRITES_TIMEOUT:
stream << "0x80042313L . ( The shadow copy provider timed out while flushing data to the volume being shadow copied.This is probably due to excessive activity on the volume. Try again later when the volume is not being used so heavily. )";
break;
case VSS_E_HOLD_WRITES_TIMEOUT:
stream << "0x80042314L . ( The shadow copy provider timed out while holding writes to the volume being shadow copied. This is probably due to excessive activity on the volume by an application or a system service. Try again later when activity on the volume is reduced.OR the system was unable to hold I/O writes. This can be a transient problem. It is recommended to wait ten minutes and try again, up to three times. )";
break;
case VSS_E_UNEXPECTED_WRITER_ERROR:
stream << "0x80042315L . ( VSS encountered problems while sending events to writers. )";
break;
case VSS_E_SNAPSHOT_SET_IN_PROGRESS:
stream << "0x80042316L . ( Another shadow copy creation is already in progress. Please wait a few moments and try again. )";
break;
case VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED:
stream << "0x80042317L . ( The provider has reached the maximum number of shadow copies that it can support OR the specified volume has already reached its maximum number of shadow copies.)";
break;
case VSS_E_WRITER_INFRASTRUCTURE:
stream << "0x80042318L . ( An error was detected in the Volume Shadow Copy Service (VSS). The problem occurred while trying to contact VSS writers.Please verify that the Event System service and the VSS service are running and check for associated errors in the event logs.)";
break;
case VSS_E_WRITER_NOT_RESPONDING:
stream << "0x80042319L . ( A writer did not respond to a GatherWriterStatus call. The writer may either have terminated or it may be stuck. Check the system and application event logs for more information.)";
break;
case VSS_E_WRITER_ALREADY_SUBSCRIBED:
stream << "0x8004231aL . ( The writer has already sucessfully called the Subscribe function. It cannot call subscribe multiple times. )";
break;
case VSS_E_UNSUPPORTED_CONTEXT:
stream << "0x8004231bL . ( The shadow copy provider does not support the specified shadow copy type.)";
break;
case VSS_E_VOLUME_IN_USE:
stream << "0x8004231dL . ( The specified shadow copy storage association is in use and so can't be deleted.)";
break;
case VSS_E_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED:
stream << "0x8004231eL . ( Maximum number of shadow copy storage associations already reached.OR the maximum number of shadow copy storage areas has been added to the shadow copy source volume.The specified shadow copy storage volume was not associated with the specified shadow copy source volume. )";
break;
case VSS_E_INSUFFICIENT_STORAGE:
stream << "0x8004231fL . ( Insufficient storage available to create either the shadow copy storage file or other shadow copy data. OR the system or provider has insufficient storage space. If possible delete any old or unnecessary persistent shadow copies and try again. )";
break;
case VSS_E_NO_SNAPSHOTS_IMPORTED:
stream << "0x80042320L . ( No shadow copies were successfully imported. )";
break;
case VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED:
stream << "0x00042321L . (Some shadow copies were not succesfully imported. )";
break;
case VSS_E_SOME_SNAPSHOTS_NOT_IMPORTED:
stream << "0x800423221L . (Some shadow copies were not succesfully imported. )";
break;
case VSS_E_MAXIMUM_NUMBER_OF_REMOTE_MACHINES_REACHED:
stream << "0x80042322L . ( The maximum number of remote machines for this operation has been reached. )";
break;
case VSS_E_REMOTE_SERVER_UNAVAILABLE:
stream << "0x80042323L . (The remote server is unavailable. )";
break;
case VSS_E_REMOTE_SERVER_UNSUPPORTED:
stream << "0x80042324L . ( The remote server is running a version of the Volume Shadow Copy Service that does not support remote shadow-copy creation. )";
break;
case VSS_E_REVERT_IN_PROGRESS:
stream << "0x80042325L . ( A revert is currently in progress for the specified volume. Another revert cannot be initiated until the current revert completes. )";
break;
case VSS_E_REVERT_VOLUME_LOST:
stream << "0x80042326L . ( The volume being reverted was lost during revert.)";
break;
case VSS_E_REBOOT_REQUIRED:
stream << "0x80042327L. ( A reboot is required after completing this operation.)";
break;
case VSS_E_TRANSACTION_FREEZE_TIMEOUT:
stream << "0x80042328L. ( A timeout occured while freezing a transaction manager.)";
break;
case VSS_E_TRANSACTION_THAW_TIMEOUT:
stream << "0x80042329L. (Too much time elapsed between freezing a transaction manager and thawing the transaction manager.)";
break;
case VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT:
stream << "0x800423F0L. (The shadow-copy set only contains only a subset of the volumes needed to correctly backup the selected components of the writer.)";
break;
case VSS_E_WRITERERROR_OUTOFRESOURCES:
stream << "0x800423F1L. (A resource allocation failed while processing this operation.)";
break;
case VSS_E_WRITERERROR_TIMEOUT:
stream << "0x800423F2L. (The writer's timeout expired between the Freeze and Thaw events.)";
break;
case VSS_E_WRITERERROR_RETRYABLE:
stream << "0x800423F3L. (The writer experienced a transient error. If the backup process is retried,the error may not reoccur.)";
break;
case VSS_E_WRITERERROR_NONRETRYABLE:
stream << "0x800423F4L. (The writer experienced a non-transient error. If the backup process is retried,the error is likely to reoccur.)";
break;
case VSS_E_WRITERERROR_RECOVERY_FAILED:
stream << "0x800423F5L. (The writer experienced an error while trying to recover the shadow-copy volume.)";
break;
case VSS_E_BREAK_REVERT_ID_FAILED:
stream << "0x800423F6L. (The shadow copy set break operation failed because the disk/partition identities could not be reverted. The target identity already exists on the machine or cluster and must be masked before this operation can succeed.)";
break;
case VSS_E_LEGACY_PROVIDER:
stream << "0x800423F7L. (This version of the hardware provider does not support this operation.)";
break;
/*
case VSS_E_BREAK_FAIL_FROM_PROVIDER :
stream << "0x800423F8L. (At least one of the providers in this Shadow Copy set failed the break operation for a snapshot.)" ;
break;
*/
case VSS_E_ASRERROR_DISK_ASSIGNMENT_FAILED:
stream << "0x80042401L. (There are too few disks on this computer or one or more of the disks is too small. Add or change disks so they match the disks in the backup, and try the restore again.)";
break;
case VSS_E_ASRERROR_DISK_RECREATION_FAILED:
stream << "0x80042402L. (Windows cannot create a disk on this computer needed to restore from the backup. Make sure the disks are properly connected, or add or change disks, and try the restore again.)";
break;
case VSS_E_ASRERROR_NO_ARCPATH:
stream << "0x80042403L. (The computer needs to be restarted to finish preparing a hard disk for restore. To continue, restart your computer and run the restore again.)";
break;
case VSS_E_ASRERROR_MISSING_DYNDISK:
stream << "0x80042404L. (The backup failed due to a missing disk for a dynamic volume. Please ensure the disk is online and retry the backup.)";
break;
case VSS_E_ASRERROR_SHARED_CRIDISK:
stream << "0x80042405L. (Automated System Recovery failed the shadow copy, because a selected critical volume is located on a cluster shared disk. This is an unsupported configuration.)";
break;
case VSS_E_ASRERROR_DATADISK_RDISK0:
stream << "0x80042406L. (A data disk is currently set as active in BIOS. Set some other disk as active or use the DiskPart utility to clean the data disk, and then retry the restore operation.)";
break;
case VSS_E_ASRERROR_RDISK0_TOOSMALL:
stream << "0x80042407L. (The disk that is set as active in BIOS is too small to recover the original system disk. Replace the disk with a larger one and retry the restore operation.)";
break;
case VSS_E_ASRERROR_CRITICAL_DISKS_TOO_SMALL:
stream << "0x80042408L. (There is not enough disk space on the system to perform the restore operation. Add another disk or replace one of the existing disks and retry the restore operation.)";
break;
case VSS_E_WRITER_STATUS_NOT_AVAILABLE:
stream << "0x80042409L. (Writer status is not available for one or more writers. A writer may have reached the limit to the number of available backup-restore session states.)";
break;
default:
stream << hex << "0x" << exitCode << " . (This error code is returned by VSS framework. Please refer to the online MSDN documentation for the description of this error code.)";
break;
}
stream << std::endl;
}
DebugPrintf(SV_LOG_DEBUG, "EXITED %s\n", FUNCTION_NAME);
}