Metodo ITPhone::get_Terminals (tapi3if.h)
Il metodo get_Terminals recupera una raccolta di terminali associati al telefono. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.
Sintassi
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
Parametri
[in] pAddress
Puntatore all'interfaccia ITAddress .
[out] pTerminals
Puntatore a un valore VARIANT contenente un oggetto ITCollection di puntatori all'interfaccia ITTerminal .
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se al telefono non sono associati terminali, questo metodo produce una raccolta vuota e restituisce S_OK.
L'applicazione non deve chiamare il metodo ITPhone::Open prima di chiamare get_Terminals. Ciò è dovuto al fatto che l'implementazione dell'oggetto telefono può aprire il telefono e chiamare phoneGetID durante l'inizializzazione TAPI o quando viene visualizzato un nuovo oggetto telefono.
TAPI chiama il metodo AddRef nell'interfaccia ITAddress restituita da ITPhone::get_Terminals. L'applicazione deve chiamare Release nell'interfaccia ITAddress per liberare le risorse associate.
Requisiti
Piattaforma di destinazione | Windows |
Intestazione | tapi3if.h (include Tapi3.h) |
Libreria | Uuid.lib |
DLL | Tapi3.dll |