IVssComponent::GetPostRestoreFailureMsg method (vswriter.h)
The GetPostRestoreFailureMsg method returns the failure message generated by a writer while handling the PostRestore event, if IVssComponent::SetPostRestoreFailureMsg set one.
Either a writer or a requester can call this method.
Syntax
HRESULT GetPostRestoreFailureMsg(
[out] BSTR *pbstrPostRestoreFailureMsg
);
Parameters
[out] pbstrPostRestoreFailureMsg
Pointer to a string containing the failure message that describes an error that occurred while processing the PostRestore event.
Return value
The following are the valid return codes for this method.
| Value | Meaning |
|---|---|
|
Successfully returned the attribute value. |
|
No PostRestoreFailure message was available to retrieve. |
|
One of the parameter values is not valid. |
|
The caller is out of memory or other system resources. |
|
The XML document is not valid. Check the event log for details. For more information, see Event and Error Handling Under VSS. |
Remarks
The caller should free the memory held by the pbstrPostRestoreFailureMsg parameter by calling SysFreeString.
If SetPostRestoreFailureMsg was not used to set a PostRestore failure message, GetPreRestoreFailureMsg returns S_FALSE.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | vswriter.h (include Vss.h, VsWriter.h) |
| Library | VssApi.lib |
See also
IVssComponent::GetPreRestoreFailureMsg