lineGetRequest-Funktion (tapi.h)

Artikel
03/02/2024

Die lineGetRequest-Funktion ruft die nächste By-Proxy-Anforderung für den angegebenen Anforderungsmodus ab.

Syntax

LONG lineGetRequest(
  HLINEAPP hLineApp,
  DWORD    dwRequestMode,
  LPVOID   lpRequestBuffer
);

Parameter

hLineApp

Das Anwendungsnutzungshandle für den Zeilenteil von TAPI.

dwRequestMode

Eine Art von Anforderung, die abgerufen werden soll. Beachten Sie, dass für dwRequestMode nur ein Bit festgelegt sein kann. Dieser Parameter verwendet nur eine der LINEREQUESTMODE_ Konstanten.

lpRequestBuffer

Ein Zeiger auf einen Speicherpuffer, in dem die Parameter der Anforderung platziert werden sollen. Die Größe des Puffers und die Interpretation der im Puffer platzierten Daten hängen vom Anforderungsmodus ab. Es wird davon ausgegangen, dass der von der Anwendung zugewiesene Puffer eine ausreichende Größe hat, um die Anforderung aufzunehmen.

Wenn dwRequestMode LINEREQUESTMODE_MAKECALL ist, interpretieren Sie den Inhalt des Anforderungspuffers mithilfe der LINEREQMAKECALL-Struktur .

LINEREQUESTMODE_MEDIACALL ist veraltet. Weitere Informationen finden Sie unter tapiRequestMediaCall.

Rückgabewert

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

LINEERR_INVALAPPHANDLE, LINEERR_NOTREGISTERED, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOREQUEST.

Hinweise

Eine telefoniefähige Anwendung kann anfordern, dass ein Anruf in ihrem Namen platziert wird, indem sie tapiRequestMakeCall aufruft. Diese Anforderungen werden von TAPI in die Warteschlange gestellt, und die Anwendung mit der höchsten Priorität, die sich für die Verarbeitung der Anforderung registriert hat, wird eine LINE_REQUEST Nachricht mit Angabe des Modus der ausstehenden Anforderung gesendet. In der Regel ist diese Anwendung die Anrufsteuerungsanwendung des Benutzers. Die LINE_REQUEST Meldung gibt an, dass für die Bearbeitung des registrierten Antrags möglicherweise null oder mehr Anforderungen ausstehen; nach dem Empfang LINE_REQUEST ist die Empfängeranwendung dafür verantwortlich, lineGetRequest aufzurufen, bis LINEERR_NOREQUEST zurückgegeben wird, was angibt, dass keine weiteren Anforderungen ausstehen.

Als Nächstes ruft die Anrufsteuerungsanwendung, die diese Nachricht empfängt , lineGetRequest auf und gibt den Anforderungsmodus und einen Puffer an, der groß genug ist, um die Anforderung aufzunehmen. Die Aufrufsteuerungsanwendung interpretiert und führt die Anforderung aus.

Nach der Ausführung von lineGetRequest löscht TAPI die Anforderung aus der internen Warteschlange, sodass Platz für eine nachfolgende Anforderung verfügbar ist. Es ist daher möglich, dass eine neue LINE_REQUEST Nachricht sofort nach der Ausführung von lineGetRequest empfangen wird, wenn dieselbe oder eine andere Anwendung eine andere Anforderung ausgibt. Es liegt in der Verantwortung der Anforderungsempfängeranwendung, dieses Szenario mit einem bestimmten Mechanismus zu behandeln. z. B. durch Notieren des zusätzlichen LINE_REQUEST und Zurückstellen einer nachfolgenden lineGetRequest , bis die Verarbeitung der vorherigen Anforderung abgeschlossen ist, indem sie die nachfolgende Anforderung und den Puffer bei Bedarf abrufen oder auf andere geeignete Weise.

Die nachfolgende LINE_REQUEST sollte nicht ignoriert werden, da sie von TAPI nicht wiederholt wird.