tapiRequestMakeCall-Funktion (tapi.h)

Die tapiRequestMakeCall-Funktion fordert die Einrichtung eines Sprachanrufs an. Eine Anruf-Manager-Anwendung ist für die Einrichtung des Aufrufs im Auftrag der anfordernden Anwendung verantwortlich, die dann von der Call-Manager-Anwendung des Benutzers gesteuert wird.

Syntax

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

Parameter

lpszDestAddress

Zeiger auf einen Speicherspeicherort, an dem sich die NULL-endende Zieladresse der Anrufanforderung befindet. Die Adresse kann das kanonische Adressformat verwenden. Die Gültigkeit der angegebenen Adresse wird durch diesen Vorgang nicht überprüft. Die maximale Länge der Adresse beträgt TAPIMAXDESTADDRESSSIZE-Zeichen, die den NULL-Abschlussator enthalten.

lpszAppName

Zeiger auf einen Speicherspeicherort, an dem sich der benutzerfreundliche Anwendungsname der Aufrufanforderung mit NULL-Beendigung befindet. Dieser Zeiger kann NULL belassen werden, wenn die Anwendung keinen Anwendungsnamen anliefert. Die maximale Länge der Adresse beträgt TAPIMAXAPPNAMESIZE-Zeichen, die den NULL-Abschlussator enthalten. Längere Zeichenfolgen werden abgeschnitten.

lpszCalledParty

Zeiger auf einen Speicherspeicherort, an dem sich der null-beendete Aufgerufene für die aufgerufene Partei des Aufrufs befindet. Dieser Zeiger kann NULL belassen werden, wenn die Anwendung diese Informationen nicht angeben möchte. Die maximale Länge der Zeichenfolge ist TAPIMAXCALLEDPARTYSIZE-Zeichen, die den NULL-Abschlussator enthält. Längere Zeichenfolgen werden abgeschnitten.

lpszComment

Zeiger auf einen Speicherspeicherort, an dem sich der NULL-beendete Kommentar zum Aufruf befindet. Dieser Zeiger kann NULL belassen werden, wenn die Anwendung keinen Kommentar liefert. Die maximale Länge der Adresse ist TAPIMAXCOMMENTSIZE-Zeichen, die den NULL-Abschlussator enthält. Längere Zeichenfolgen werden abgeschnitten.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Fehlerrückgabewerte sind:

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.

Hinweise

Eine telefoniefähige Anwendung kann anfordern, dass ein Anruf in ihrem Namen platziert wird, indem sie tapiRequestMakeCall aufruft und nur die Zieladresse für den Anruf angibt. Diese Anforderung wird an die Anrufsteuerungsanwendung des Benutzers weitergeleitet, die den Aufruf im Namen der ursprünglichen Anwendung ablegt. Eine Standardmäßige Anrufsteuerungsanwendung wird als Teil der Telefonie bereitgestellt. Benutzer können dies durch eine Anrufsteuerungsanwendung ihrer Wahl ersetzen.

Beim Aufrufen von tapiRequestMakeCall , wenn keine Anrufsteuerungsanwendung ausgeführt wird, wird die TAPIERR_NOREQUESTRECIPIENT Fehleranzeige zurückgegeben. Wenn die Anrufsteuerungsanwendung nicht ausgeführt wird, versucht TAPI, die Anrufsteuerungsanwendung mit der höchsten Priorität zu starten (die für RequestMakeCall in der Registrierung aufgeführt ist). Wenn Sie diese Funktion aufrufen, wenn die Unterstützte TAPI-Anforderungswarteschlange voll ist, wird der TAPIERR_REQUESTQUEUEFULL Fehler zurückgegeben.

Anforderungen

Weitere Informationen

Referenz zu unterstützten Telefoniediensten

ÜBERSICHT ÜBER TAPI 2.2-Referenz