tapiRequestMakeCallW-Funktion (tapi.h)

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

Syntax

LONG tapiRequestMakeCallW(
  LPCWSTR lpszDestAddress,
  LPCWSTR lpszAppName,
  LPCWSTR lpszCalledParty,
  LPCWSTR lpszComment
);

Parameter

lpszDestAddress

Zeigen Sie auf einen Speicherspeicherort, an dem sich die null-terminated-Zieladresse der Anrufanforderung befindet. Die Adresse kann das kanonische Adresse Format verwenden. Die Gültigkeit der angegebenen Adresse wird durch diesen Vorgang nicht überprüft. Die maximale Länge der Adresse ist TAPIMAXDESTADDRESSSIZE-Zeichen, die den NULL Endator enthalten.

lpszAppName

Zeigen Sie auf einen Speicherort, an dem sich der null-terminated-benutzerfreundlicher Anwendungsname der Anrufanforderung befindet. Dieser Zeiger kann NULL- gelassen werden, wenn die Anwendung keinen Anwendungsnamen annimmt. Die maximale Länge der Adresse ist TAPIMAXAPPNAMESIZE-Zeichen, die den NULL- Endator enthalten. Längere Zeichenfolgen werden abgeschnitten.

lpszCalledParty

Zeigen Sie auf einen Speicherspeicherort, an dem sich der NULL--terminated-Partyname für die angerufene Partei des Anrufs befindet. Dieser Zeiger kann NULL- gelassen werden, wenn die Anwendung diese Informationen nicht angeben möchte. Die maximale Länge der Zeichenfolge ist TAPIMAXCALLEDPARTYSIZE-Zeichen, die den NULL Endator enthalten. Längere Zeichenfolgen werden abgeschnitten.

lpszComment

Zeigen Sie auf einen Speicherort, an dem sich der null-terminated kommentar zu dem Anruf befindet. Dieser Zeiger kann NULL- gelassen werden, wenn die Anwendung keinen Kommentar liefert. Die maximale Länge der Adresse ist TAPIMAXCOMMENTSIZE-Zeichen, die den NULL- Endator enthalten. Längere Zeichenfolgen werden abgeschnitten.

Rückgabewert

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

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.

Bemerkungen

Eine telefonfähige Anwendung kann anfordern, dass ein Anruf in seinem Namen getätigt wird, indem er tapiRequestMakeCallaufruft und nur die Zieladresse für den Anruf bereitstellt. Diese Anforderung wird an die Anrufsteuerungsanwendung des Benutzers weitergeleitet, die den Anruf im Namen der ursprünglichen Anwendung platziert. Eine Standardmäßige Anrufsteuerungsanwendung wird als Teil der Telefonie bereitgestellt. Benutzer können dies durch eine Anrufsteuerungsanwendung ihrer Wahl ersetzen.

Das Aufrufen tapiRequestMakeCall-, wenn keine Aufrufsteuerungsanwendung ausgeführt wird, gibt die TAPIERR_NOREQUESTRECIPIENT Fehleranzeige zurück. Wenn die Anrufsteuerungsanwendung nicht ausgeführt wird, versucht TAPI, die Anwendung für die Anrufsteuerung mit der höchsten Priorität zu starten (die für RequestMakeCall- in der Registrierung aufgeführt ist). Das Aufrufen dieser Funktion, wenn die Warteschlange für die unterstützte TAPI-Anforderung voll ist, gibt den TAPIERR_REQUESTQUEUEFULL Fehler zurück.

Anmerkung

Der tapi.h-Header definiert tapiRequestMakeCall als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu unterstützten Telefoniediensten

TAPI 2.2 Referenzübersicht