SetEnlistmentRecoveryInformation function (ktmw32.h)
Sets an opaque, user-defined structure of recovery data from KTM. Recovery information is stored in a log on behalf of a resource manager (RM) by calling SetEnlistmentRecoveryInformation. After a failure, the RM can use GetEnlistmentRecoveryInformation to retrieve the information.
Syntax
BOOL SetEnlistmentRecoveryInformation(
[in] HANDLE EnlistmentHandle,
[in] ULONG BufferSize,
[in] PVOID Buffer
);
Parameters
[in] EnlistmentHandle
A handle to the enlistment.
[in] BufferSize
The size of Buffer, in bytes.
[in] Buffer
The recovery information.
Return value
If the function succeeds, the return value is nonzero.
If the function fails, the return value is 0 (zero). To get extended error information, call the GetLastError function.
The following list identifies the possible error codes:
Remarks
This call cannot be used with volatile transaction managers.
The information that is provided by the user may not be durably stored in the log at the completion of this operation, but it will be durably stored by the end of the next commit operation for this enlistment.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | ktmw32.h |
| Library | Ktmw32.lib |
| DLL | Ktmw32.dll |