Metodo ITAddress::CreateCall (tapi3if.h)

Articolo
03/08/2023

Il metodo CreateCall crea un nuovo oggetto Call che può essere usato per effettuare una chiamata in uscita e restituisce un puntatore all'interfaccia ITBasicCallControl dell'oggetto. La chiamata appena creata si trova nello stato CS_IDLE e non dispone di supporti o terminali selezionati.

I valori di input accettabili per l'indirizzo di chiamata, il tipo di indirizzo e i tipi di supporti sono specifici del provider di servizi di telefonia che supportano l'indirizzo corrente. Per informazioni sui provider di servizi di telefonia (TSP) forniti con Windows 2000, vedere Informazioni sul provider di servizi di telefonia (TSP). Per i TSP di terze parti, vedere la documentazione fornita dalla vender.

Sintassi

HRESULT CreateCall(
  [in]  BSTR               pDestAddress,
  [in]  long               lAddressType,
  [in]  long               lMediaTypes,
  [out] ITBasicCallControl **ppCall
);

Parametri

[in] pDestAddress

Questa stringa BSTR contiene un indirizzo di destinazione. Il formato è specifico del provider. Questo puntatore può essere NULL per gli indirizzi non visualizzati (ad esempio con un telefono frequente) o quando viene eseguita tutta la composizione usando ITBasicCallControl::D ial. NULL in combinazione con un pGroupIDNULL in ITBasicCallControl::P ickup genera un ritiro del gruppo. I provider di servizi con funzionalità multiplexing inversa possono consentire a un'applicazione di specificare più indirizzi contemporaneamente.

[in] lAddressType

Contiene una costante del tipo di indirizzo , ad esempio LINEADDRESSTYPE_PHONENUMBER, che descrive il formato dell'indirizzo. Il valore deve essere valido per questo indirizzo. Usare ITAddressCapabilities::get_AddressCapability con AddressCap impostato su AC_ADDRESSTYPES per verificare il valore.

[in] lMediaTypes

Identifica il tipo di supporto o i tipi coinvolti nella sessione di chiamata.

[out] ppCall

Puntatore all'interfaccia ITBasicCallControl .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il tipo di indirizzo, lAddressType, non è valido o specifica più di un tipo di indirizzo.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro ppCall non è un puntatore valido.

Commenti

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

Quando il tipo di indirizzo è LINEADDRESSTYPE_SDP, l'applicazione deve chiamare il metodo ITSDP::get_IsValid su pDestAddress per verificare che le informazioni SDP contenute siano costruite correttamente in base a RFC 2327.

Le chiamate usate come chiamate di consultazione, ad esempio durante una conferenza, il trasferimento o l'operazione di inoltro, devono essere create usando questo metodo.

TAPI chiama il metodo AddRef nell'interfaccia ITBasicCallControl restituita da ITAddress::CreateCall. L'applicazione deve chiamare Release nell'interfaccia ITBasicCallControl per liberare risorse associate.

Nota Questo metodo non è esattamente lo stesso di lineMakeCall in TAPI 2. Fornisce TAPI con molte delle stesse informazioni, ma le operazioni parallele non vengono eseguite finché non viene chiamato ITBasicCallControl::Connect .