Sets extended error information to indicate that the writer has encountered a problem with participating in a VSS operation.
HRESULT SetWriterFailureEx( [in] HRESULT hrWriter, [in] HRESULT hrApplication, [in] LPCWSTR wszApplicationMessage );
- hrWriter [in]
The error code to be returned to the requester.
The following are the error codes that this method can set.
The writer was successful.
The shadow copy contains only a subset of the volumes needed by the writer to correctly back up the application component.
The writer ran out of memory or other system resources. The recommended way to handle this error code is to wait ten minutes and then repeat the operation, up to three times.
The writer operation failed because of a time-out between the Freeze and Thaw events. The recommended way to handle this error code is to wait ten minutes and then repeat the operation, up to three times.
The writer failed due to an error that would likely not occur if the entire backup, restore, or shadow copy creation process was restarted. The recommended way to handle this error code is to wait ten minutes and then repeat the operation, up to three times.
The writer operation failed because of an error that might recur if another shadow copy is created. For more information, see Event and Error Handling Under VSS.
The writer is reporting one or more component-level errors. To report the errors, the writer must use the IVssComponentEx2::SetFailure method.
- hrApplication [in]
An additional error code to be returned to the requester. This parameter is optional.
- wszApplicationMessage [in]
A string containing an error message for the requester to display to the end user. The writer is responsible for localizing this string if necessary before using it in this method. This parameter is optional and can be NULL or an empty string.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
To report component-level errors, writers should use the IVssComponentEx2::SetFailure method.
Minimum supported client
|Windows 7 [desktop apps only]|
Minimum supported server
|Windows Server 2008 R2 [desktop apps only]|