ITTerminalSupport::CreateTerminal method (tapi3if.h)
Metode CreateTerminal membuat dan menginisialisasi objek ITTerminal baru berdasarkan kelas terminal dinamis dan media. Kelas terminal diidentifikasi oleh GUID. GUID harus dikonversi ke string menggunakan StringFromIID untuk diteruskan ke metode ini.
Sintaks
HRESULT CreateTerminal(
[in] BSTR pTerminalClass,
[in] long lMediaType,
[in] TERMINAL_DIRECTION Direction,
[out] ITTerminal **ppTerminal
);
Parameter
[in] pTerminalClass
Pointer ke BSTR yang berisi kelas terminal (GUID) untuk objek terminal baru.
[in] lMediaType
Arahkan ke jenis media untuk objek terminal baru.
[in] Direction
TERMINAL_DIRECTION pendeskripsi arah terminal.
[out] ppTerminal
Penunjuk ke objek ITTerminal yang dibuat.
Menampilkan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Nilai | Makna |
---|---|
|
Metode berhasil. |
|
Parameter pTerminalClass atau lMediaType tidak valid. |
|
Parameter ppTerminal bukan penunjuk yang valid. |
|
Memori tidak cukup ada untuk membuat objek ITTerminal . |
|
Parameter lMediaType tidak valid. |
|
Pembuatan terminal dinamis tidak didukung. |
Keterangan
Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pTerminalClass dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.
Setelah terminal dibuat, terminal hanya dapat dipilih ke satu panggilan.
TAPI memanggil metode AddRef pada antarmuka ITTerminal yang dikembalikan oleh ITTerminalSupport::CreateTerminal. Aplikasi harus memanggil Rilis pada antarmuka ITTerminal ke sumber daya gratis yang terkait dengannya.
Persyaratan
Target Platform | Windows |
Header | tapi3if.h (termasuk Tapi3.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk