VixHandle VixVM_CreateSnapshot(VixHandle vmHandle, const char *name, const char *description, int options, VixHandle propertyListHandle, VixEventProc *callbackProc, void *clientData);
This function saves a copy of the virtual machine state as a snapshot object. The handle of the snapshot object is returned in the job object properties.
VixError err = VIX_OK; VixHandle hostHandle = VIX_INVALID_HANDLE; VixHandle jobHandle = VIX_INVALID_HANDLE; VixHandle vmHandle = VIX_INVALID_HANDLE; VixHandle snapshotHandle = VIX_INVALID_HANDLE; jobHandle = VixHost_Connect(VIX_API_VERSION, VIX_SERVICEPROVIDER_VMWARE_WORKSTATION, NULL, // hostName 0, // hostPort NULL, // userName NULL, // password 0, // options VIX_INVALID_HANDLE, // propertyListHandle NULL, // callbackProc NULL); // clientData err = VixJob_Wait(jobHandle, VIX_PROPERTY_JOB_RESULT_HANDLE, &hostHandle, VIX_PROPERTY_NONE); if (VIX_OK != err) { // Handle the error... goto abort; } // Release handle after use: Vix_ReleaseHandle(jobHandle); jobHandle = VixVM_Open(hostHandle, "c:\\Virtual Machines\\vm1\\win2000.vmx", NULL, // callbackProc NULL); // clientData err = VixJob_Wait(jobHandle, VIX_PROPERTY_JOB_RESULT_HANDLE, &vmHandle, VIX_PROPERTY_NONE); if (VIX_OK != err) { // Handle the error... goto abort; } // Release handle after use: Vix_ReleaseHandle(jobHandle); // Power on the virtual machine before copying file. jobHandle = VixVM_PowerOn(vmHandle, 0, // powerOnOptions VIX_INVALID_HANDLE, // propertyListHandle NULL, // callbackProc NULL); // clientData err = VixJob_Wait(jobHandle,VIX_PROPERTY_NONE); if (VIX_OK != err) { // Handle the error... goto abort; } // Release handle after use: Vix_ReleaseHandle(jobHandle); // Create snapshot in powered-on state. jobHandle = VixVM_CreateSnapshot(vmHandle, NULL, // name NULL, // description VIX_SNAPSHOT_INCLUDE_MEMORY, // options VIX_INVALID_HANDLE, // propertyListHandle NULL, // callbackProc NULL); // clientData err = VixJob_Wait(jobHandle, VIX_PROPERTY_JOB_RESULT_HANDLE, &snapshotHandle, VIX_PROPERTY_NONE); abort: Vix_ReleaseHandle(jobHandle); Vix_ReleaseHandle(snapshotHandle); Vix_ReleaseHandle(vmHandle); VixHost_Disconnect(hostHandle);