Metodo ITTerminalSupport::CreateTerminal (tapi3if.h)

Articolo
08/26/2023

Il metodo CreateTerminal crea e inizializza un nuovo oggetto ITTerminal basato sulla classe del terminale dinamico e sui supporti. La classe terminale è identificata da un GUID. Il GUID deve essere convertito in una stringa usando StringFromIID per passare a questo metodo.

Sintassi

HRESULT CreateTerminal(
  [in]  BSTR               pTerminalClass,
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

Parametri

[in] pTerminalClass

Puntatore a BSTR contenente la classe terminale (GUID) per il nuovo oggetto terminale.

[in] lMediaType

Puntatore al tipo di supporto per il nuovo oggetto terminale.

[in] Direction

TERMINAL_DIRECTION descrittore della direzione del terminale.

[out] ppTerminal

Puntatore all'oggetto ITTerminal creato.

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Significato
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro pTerminalClass o lMediaType non è valido.
E_POINTER	Il parametro ppTerminal non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per creare l'oggetto ITTerminal .
E_MEDIATYPE	Il parametro lMediaType non è valido.
TAPI_E_NOTSUPPORTED	La creazione dinamica del terminale non è supportata.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pTerminalClass e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

Dopo aver creato un terminale, può essere selezionato su una sola chiamata.

TAPI chiama il metodo AddRef nell'interfaccia ITTerminal restituita da ITTerminalSupport::CreateTerminal. L'applicazione deve chiamare Release nell'interfaccia ITTerminal per liberare risorse associate.