Microsoft SQL Server Virtual Backup Device Specification
IClientVirtualDeviceSet2::OpenInSecondaryEx
| Purpose | This function opens the virtual device set in a secondary client. The primary client must have already used CreateEx and GetConfiguration to set up the virtual device set. | |
| Syntax | HRESULT IClientVirtualDeviceSet2::OpenInSecondaryEx (
|
|
| Parameters | Argument | Explanation |
|---|---|---|
| lpInstanceName | This string identifies the SQL Server instance to which the SQL command will be sent. | |
| lpSetName | This identifies the set. This name is case-sensitive and must match the name used by the primary client when it invoked IClientVirtualDeviceSet2::Create. | |
| Return Values | Argument | Explanation |
| NOERROR | The function succeeded. | |
| VD_E_PROTOCOL | The virtual device set has been opened or the virtual device set is not ready to accept open requests from secondary clients. | |
| VD_E_ABORT | The operation is being aborted. | |
| Remarks | When using a multiple process model, the primary client is responsible for detecting normal and abnormal termination of secondary clients. The instance name must identify the instance to which the T-SQL is issued. NULL identifies the default instance. No "machineName\" prefix is accepted. OpenInSecondaryEx supersedes the original IClientVirtualDeviceSet::OpenInSecondary that was defined in the original SQL Server version 7.0 interface. New development should use OpenInSecondaryEx. |
|