Name

Description

HRESULT
EndReplay(LONG options,
          IVixHandle* propertyList,
          ICallback* jobDoneCallback,
          IJob** recordingJob);

This function stops replaying a virtual machine's recording.

Parameters

options

Must be zero.

propertyListHandle

Must be NULL (C++), null (C#), or Nothing (VB).

jobDoneCallback

An ICallback instance that will be called when the operation is complete.

replayJob

Returns an IJob object that describes the state of this asynchronous operation.

Return Value

Remarks

• Record-replay functionality has been deprecated and this function may be removed from future versions of the VIX API.
• This operation only works on a virtual machine that is replaying.
• This function will cause the virtual machine to "go live"; it will resume normal execution, continuing on from the last state that was replayed from the recording.
• This function is not supported when using the VixCOM.Constants.VIX_SERVICEPROVIDER_VMWARE_PLAYER host type.

Side Effects

Requirements

Example

' Power off the virtual machine before replaying the recording.
Set job = vm.PowerOff(0, Nothing)
err = job.WaitWithoutResults()
If lib.ErrorIndicatesFailure(err) Then
   ' Handle the error...
End If

Set job = vm.BeginReplay(recording, 0, Nothing, Nothing)
err = job.WaitWithoutResults()
If lib.ErrorIndicatesFailure(err) Then
   ' Handle the error...
End If

' And once you want to stop replaying...

Set job = vm.EndReplay(0, Nothing, Nothing)
err = job.WaitWithoutResults()
If lib.ErrorIndicatesFailure(err) Then
   ' Handle the error...
End If

Set job = Nothing