ITAddress::CreateCall-Methode (tapi3if.h)

Artikel
08/26/2023

Die CreateCall-Methode erstellt ein neues Call-Objekt, das zum Tätigen eines ausgehenden Aufrufs verwendet werden kann, und gibt einen Zeiger auf die ITBasicCallControl-Schnittstelle des Objekts zurück. Der neu erstellte Aufruf befindet sich im CS_IDLE Zustand und hat keine Medien oder Terminals ausgewählt.

Zulässige Eingabewerte für Anrufadresse, Adresstyp und Medientypen sind spezifisch für den Telefoniedienstanbieter, der die aktuelle Adresse unterstützt. Informationen zu tsPs, die mit Windows 2000 ausgeliefert werden, finden Sie unter Informationen zum Telefoniedienstanbieter (TSP). Informationen zu Drittanbieter-TSPs finden Sie in der Dokumentation, die vom Vender bereitgestellt wird.

Syntax

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

Parameter

[in] pDestAddress

Diese BSTR-Zeichenfolge enthält eine Zieladresse. Das Format ist anbieterspezifisch. Dieser Zeiger kann NULL für nicht gewählte Adressen (z. B. bei einem Heißen Telefon) oder wenn alle Wählvorgänge mithilfe von ITBasicCallControl::D ial ausgeführt werden. NULL in Kombination mit einer NULLpGroupID in ITBasicCallControl::P ickup führt zu einer Gruppenabholung. Dienstanbieter mit Inverse-Multiplexingfunktionen können es einer Anwendung ermöglichen, mehrere Adressen gleichzeitig anzugeben.

[in] lAddressType

Enthält eine Adresstypkonstante , z. B. LINEADDRESSTYPE_PHONENUMBER, die das Format der Adresse beschreibt. Der Wert muss für diese Adresse gültig sein. Verwenden Sie ITAddressCapabilities::get_AddressCapability , wobei AddressCap auf AC_ADDRESSTYPES festgelegt ist, um den Wert zu überprüfen.

[in] lMediaTypes

Gibt den Medientyp bzw. die Medientypen an, die an der Anrufsitzung beteiligt sein werden.

[out] ppCall

Zeiger auf die ITBasicCallControl-Schnittstelle .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_INVALIDARG	Der Adresstyp lAddressType ist ungültig oder gibt mehrere Adresstypen an.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_POINTER	Der ppCall-Parameter ist kein gültiger Zeiger.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDestAddress-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

Wenn der Adresstyp LINEADDRESSTYPE_SDP ist, sollte die Anwendung die ITSDP::get_IsValid-Methode auf pDestAddress aufrufen, um zu überprüfen, ob die enthaltenen SDP-Informationen ordnungsgemäß gemäß RFC 2327 erstellt sind.

Aufrufe, die als Konsultationsaufrufe verwendet werden, z. B. während einer Konferenz, Übertragung oder Weiterleitung, müssen mit dieser Methode erstellt werden.

TAPI ruft die AddRef-Methode auf der von ITAddress::CreateCall zurückgegebenen ITBasicCallControl-Schnittstelle auf. Die Anwendung muss Release auf der ITBasicCallControl-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Hinweis Diese Methode ist nicht genau identisch mit lineMakeCall in TAPI 2. Es stellt TAPI viele der gleichen Informationen zur Verfügung, aber parallele Vorgänge werden erst ausgeführt, wenn ITBasicCallControl::Connect aufgerufen wird.