ITTerminalSupport::CreateTerminal-Methode (tapi3if.h)

Artikel
08/26/2023

Die CreateTerminal-Methode erstellt und initialisiert ein neues ITTerminal-Objekt basierend auf der dynamischen Terminalklasse und den dynamischen Medien. Die Terminalklasse wird durch eine GUID identifiziert. Die GUID muss mithilfe von StringFromIID in eine Zeichenfolge konvertiert werden, um an diese Methode zu übergeben.

Syntax

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

Parameter

[in] pTerminalClass

Zeiger auf BSTR , der die Terminalklasse (GUID) für das neue Terminalobjekt enthält.

[in] lMediaType

Zeiger auf den Medientyp für das neue Terminalobjekt.

[in] Direction

TERMINAL_DIRECTION Deskriptor der Endrichtung.

[out] ppTerminal

Zeiger auf das erstellte ITTerminal-Objekt .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_INVALIDARG	Der Parameter pTerminalClass oder lMediaType ist ungültig.
E_POINTER	Der ppTerminal-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das ITTerminal-Objekt zu erstellen.
E_MEDIATYPE	Der lMediaType-Parameter ist ungültig.
TAPI_E_NOTSUPPORTED	Dynamische Terminalerstellung wird nicht unterstützt.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pTerminalClass-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.

Sobald ein Terminal erstellt wurde, kann es für nur einen Anruf ausgewählt werden.

TAPI ruft die AddRef-Methode auf der ITTerminal-Schnittstelle auf, die von ITTerminalSupport::CreateTerminal zurückgegeben wird. Die Anwendung muss Release auf der ITTerminal-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.