ITTerminalSupport::CreateTerminal method (tapi3if.h)

Artikel
03/08/2023

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
S_OK	Metode berhasil.
E_INVALIDARG	Parameter pTerminalClass atau lMediaType tidak valid.
E_POINTER	Parameter ppTerminal bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk membuat objek ITTerminal .
E_MEDIATYPE	Parameter lMediaType tidak valid.
TAPI_E_NOTSUPPORTED	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.