IVMSerialPort::Konfigurasikan metode

[Windows Virtual PC tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan penyedia Hyper-V WMI (V2).]

Mengonfigurasi port serial.

Sintaks

HRESULT Configure(
  [in] VMSerialPortType portType,
  [in] BSTR             portName,
  [in] VARIANT_BOOL     vmConnectImmediately
);

portType [in]: Jenis port serial. Untuk daftar nilai, lihat VMSerialPortType.
portName [in]: Nama port serial. Misalnya, "COM1" untuk vmSerialPort_HostPort, "C:\SerialPort.txt" untuk vmSerialPort_TextFile, atau "\\servername\pipe\pipename" untuk vmSerialPort_NamedPipe.
vmConnectImmediately [in]: TRUE jika port serial host harus segera dibuka ketika komputer virtual dimulai dan FALSE sebaliknya. Diabaikan jika portType tidak vmSerialPort_HostPort.

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil.
E_INVALIDARG 0x80000003	Parameter portType tidak valid.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.
E_POINTER 0x80004003	Parameter portName adalah NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	Tidak tersedia cukup memori untuk menyelesaikan permintaan ini.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Jalur yang ditentukan oleh parameter portName terlalu panjang. Jalur harus kurang dari MAX_PATH (260) karakter.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Parameter portName berisi karakter yang tidak valid (salah satu dari "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Parameter portName menentukan jalur kosong atau relatif. Jalur absolut diperlukan.
VM_E_VM_UNKNOWN 0xA0040207	Konfigurasi untuk komputer virtual ini tidak valid.
VM_E_PREF_ILLEGAL_VALUE 0xA0040301	Port yang ditentukan sudah digunakan.

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Akhir dukungan klien	Windows 7
Produk	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMSerialPort didefinisikan sebagai 2ce4460d-1d3f-4458-bf8b-44084b816815