IClientVirtualDeviceSet2::OpenInSecondaryEx

Microsoft SQL Server Virtual Backup

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 (

   LPCWSTR      lpInstanceName,

   LPCWSTR      lpSetName

);

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.