Name

VixVM_CreateTempFileInGuest

Description

VixHandle
VixVM_CreateTempFileInGuest(VixHandle vmHandle,
                            int options,
                            VixHandle propertyListHandle,
                            VixEventProc *callbackProc,
                            void *clientData);

This function creates a temporary file in the guest operating system.

Parameters

vmHandle
Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
options
Must be 0.
propertyListHandle
Must be VIX_INVALID_HANDLE.
callbackProc
A callback function that will be invoked when the operation is complete.
clientData
A parameter that will be passed to the callbackProc function.

Return Value

VixHandle. A job handle that describes the state of this asynchronous operation.

Remarks

Side Effects

None.

Requirements

vix.h, since VMware Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

Example

char *tempFilePath;

jobHandle = VixVM_CreateTempFileInGuest(vmHandle,
                                        0,
                                        VIX_INVALID_HANDLE,
					NULL,
					NULL);
err = VixJob_Wait(jobHandle,
                  VIX_PROPERTY_JOB_RESULT_ITEM_NAME,
		  &tempFilePath,
		  VIX_PROPERTY_NONE);
if (VIX_FAILED(err)) {
   // Handle the error...
}

// Use the file.

Vix_FreeBuffer(tempFilePath);

Copyright (C) 2007-2010 VMware, Inc. All rights reserved.