Microsoft SQL Server Virtual Backup Device Specification
IClientVirtualDeviceSet2::MapBufferHandle
| Purpose | This function is used to obtain a valid buffer address from a buffer handle obtained from some other process. | |
| Syntax | HRESULT IClientVirtualDeviceSet2::MapBufferHandle (
|
|
| Parameters | Argument | Explanation |
|---|---|---|
| dwBuffer | This is the handle returned by IClientVirtualDeviceSet2::GetBufferHandle. | |
| ppBuffer | This is the address of the buffer that is valid in the current process. | |
| Return Values | Argument | Explanation |
| NOERROR | The function succeeded. | |
| VD_E_PROTOCOL | The virtual device set is not currently open. | |
| VD_E_INVALID | The ppBuffer is an invalid handle. | |
| Remarks | Care must be taken to communicate the handles correctly. Handles are local to a single virtual device set. The partner processes sharing a handle must ensure that buffer handles are used only within the scope of the virtual device set from which the buffer was originally obtained. | |