IVMFloppyDrive::AttachImage method

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Attaches a floppy media image on the host to the floppy drive of the virtual machine.

Syntax

HRESULT AttachImage(
  [in] BSTR mediaImagePath
);

mediaImagePath [in]: The full path to the floppy media image that is to be attached.

This method can return one of these values.

Return code/value	Description
S_OK 0	The operation was successful.
E_INVALIDARG 0x80000003	The mediaImagePath parameter is not valid.
E_POINTER 0x80004003	The parameter is NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	There is not enough memory available to complete this request.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	The path specified by the mediaImagePath parameter is too long. The path must be less than MAX_PATH (260) characters.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	The mediaImagePath parameter contains an invalid character (one of "*?<>/\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	The mediaImagePath parameter specifies an empty or relative path. An absolute path is required.
VM_E_VM_UNKNOWN 0xA0040207	The configuration for this virtual machine is not valid or cannot be found.
VM_E_IMAGE_CAPTURE_FAIL 0xA00400650	The image file specified could not be captured.
DISP_E_EXCEPTION 0x80020009	An unexpected error has occurred.

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows 7
Product	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMFloppyDrive is defined as 661abee6-112a-4ed9-babf-3c874969f10e