Metode IVMVirtualMachine::StartCommunicationChannel

  • Artikel

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

Menyiapkan saluran komunikasi antara host dan sistem operasi tamu.

Sintaks

HRESULT StartCommunicationChannel(
  [in] VMEndpointType inHostEndpointType,
  [in] BSTR           inHostEndPointName,
  [in] VMEndpointType inGuestEndpointType,
  [in] BSTR           inGuestEndpointName
);

Parameter

inHostEndpointType [in]

Parameter ini harus vmEndpoint_NamedPipe (0).

inHostEndPointName [in]

Nama pipa yang unik. String ini harus memiliki formulir berikut: "\\.\pipe\pipename". Bagian nama pipa dari nama dapat mencakup karakter apa pun selain garis miring terbelakang, termasuk angka dan karakter khusus. Seluruh string nama pipa dapat memiliki panjang hingga 256 karakter. Nama pipa tidak peka huruf besar/kecil.

inGuestEndpointType [in]

Parameter ini harus vmEndpoint_TCPIP (1).

inGuestEndpointName [in]

Nomor port tempat server TCP di tamu mendengarkan.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_INVALIDARG
0x80000003
 Parameter inHostEndpointType tidak vmEndpoint_NamedPipe (0) atau parameter inGuestEndpointType tidak vmEndpoint_TCPIP (1).
E_POINTER
0x80004003
 Parameter inHostEndPointName atau inGuestEndpointName adalah NULL atau bukan nilai yang valid.
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 Handel tidak valid.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Tidak tersedia cukup memori untuk menyelesaikan permintaan ini.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 Sistem dasar yang digunakannya untuk menyediakan layanan jaringan saat ini sedang diinisialisasi.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Nama pipa sudah digunakan.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 Satu atau beberapa saluran tidak berfungsi dan mungkin segera tersedia.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 Jumlah maksimum saluran komunikasi yang tersedia sedang digunakan. Saluran lain tidak dapat dimulai saat ini.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 Ada ketidakcocokan antara versi host dan subsistem tamu. Lihat Log Peristiwa Windows untuk detail selengkapnya.
VM_E_VM_NOT_RUNNING
0xA0040206
 VM tidak berjalan.

Keterangan

Implementasi saat ini hanya mendukung antarmuka pipa bernama pada host dan antarmuka TCP/IP pada sistem operasi tamu.

Persyaratan

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_IVMVirtualMachine didefinisikan sebagai f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Lihat juga

IVMVirtualMachine

VMEndpointType