ITSubStream ::get_Terminals, méthode (tapi3if.h)

Article
03/02/2024

La méthode get_Terminals crée une collection de terminaux associés au sous-flux actuel. Fourni pour les applications clientes Automation, telles que celles écrites en Visual Basic. Les applications C et C++ doivent utiliser la méthode EnumerateTerminals .

Syntaxe

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

Paramètres

[out] pTerminals

Pointeur vers VARIANT contenant une ITCollection de pointeurs d’interface ITTerminal (objets terminal).

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre pTerminals n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

Cette méthode retourne uniquement les terminaux sélectionnés dans le sous-flux. D’autres terminaux peuvent être sélectionnés sur le flux ou sur d’autres sous-flux dans le flux ; ces terminaux ne sont pas retournés.

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