Rediger

Del via


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
);

Parameters

mediaImagePath [in]

The full path to the floppy media image that is to be attached.

Return value

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.

Requirements

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

See also

IVMFloppyDrive