ITTerminalSupport::CreateTerminal, méthode (tapi3if.h)

Article
08/26/2023

La méthode CreateTerminal crée et initialise un nouvel objet ITTerminal en fonction de la classe de terminal dynamique et du média. La classe de terminal est identifiée par un GUID. Le GUID doit être converti en chaîne à l’aide de StringFromIID pour passer à cette méthode.

Syntaxe

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

Paramètres

[in] pTerminalClass

Pointeur vers BSTR contenant la classe de terminal (GUID) du nouvel objet terminal.

[in] lMediaType

Pointeur vers le type de média pour le nouvel objet terminal.

[in] Direction

TERMINAL_DIRECTION descripteur de la direction du terminal.

[out] ppTerminal

Pointeur vers l’objet ITTerminal créé.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_INVALIDARG	Le paramètre pTerminalClass ou lMediaType n’est pas valide.
E_POINTER	Le paramètre ppTerminal n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour créer l’objet ITTerminal .
E_MEDIATYPE	Le paramètre lMediaType n’est pas valide.
TAPI_E_NOTSUPPORTED	La création de terminal dynamique n’est pas prise en charge.

Remarques

L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pTerminalClass et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Une fois qu’un terminal est créé, il peut être sélectionné sur un seul appel.

TAPI appelle la méthode AddRef sur l’interface ITTerminal retournée par ITTerminalSupport::CreateTerminal. L’application doit appeler Release sur l’interface ITTerminal pour libérer les ressources qui lui sont associées.