Microsoft SQL Server Virtual Backup Device Specification
IServerVirtualDeviceSet2::ExecuteCompletionAgent
| Purpose | This function is used to implement the main loop of the completion agent. | |
| Syntax | HRESULT IServerVirtualDeviceSet2::ExecuteCompletionAgent (); |
|
| Parameters | Argument | Explanation |
|---|---|---|
| None | Not applicable | |
| Return Values | Argument | Explanation |
| NOERROR | The function succeeded. | |
| Remarks | The completion agent provides a mechanism through which SQL Server can synchronize itself with virtual device command completions. It must be active before any commands can be issued and it should remain active until all devices are closed. Since SQL Server might have to perform special thread initialization, this interface does not start a new thread of control. Instead, SQL Server sets up a thread, and then passes control to this routine. The thread must be blockable on Windows NT Inter-process Communication (IPC) mechanisms and capable of calling any of the callback functions that are provided with commands sent through IServerVirtualDevice::SendCommand. This function will not return until IServerVirtualDeviceSet2::Close or SignalAbort is invoked. |
|