lineRegisterRequestRecipient-Funktion (tapi.h)

Artikel
03/02/2024

Die lineRegisterRequestRecipient-Funktion registriert die aufrufende Anwendung als Empfänger von Anforderungen für den angegebenen Anforderungsmodus.

Syntax

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Parameter

hLineApp

Verwendungshandle der Anwendung für den Zeilenteil der TAPI.

dwRegistrationInstance

Anwendungsspezifisches DWORD, das als Parameter der LINE_REQUEST Nachricht zurückgegeben wird. Diese Meldung benachrichtigt die Anwendung, dass eine Anforderung aussteht. Dieser Parameter wird ignoriert, wenn bEnable auf 0 festgelegt ist. Dieser Parameter wird von TAPI nur für die Registrierung, nicht für die Aufhebung der Registrierung überprüft. Der dwRegistrationInstance-Wert , der beim Aufheben der Registrierung verwendet wird, muss nicht mit der dwRegistrationInstance übereinstimmen, die bei der Registrierung für einen Anforderungsmodus verwendet wurde.

dwRequestMode

Typ der Anforderung, für die sich die Anwendung registriert. Dieser Parameter verwendet eine oder mehrere der LINEREQUESTMODE_ Konstanten.

bEnable

Bei TRUE registriert die Anwendung die angegebenen Anforderungsmodi. Wenn FALSE, wird die Registrierung der Anwendung für die angegebenen Anforderungsmodi aufgehoben.

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_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

Eine telefoniefähige Anwendung kann anfordern, dass ein Anruf in ihrem Namen durchgeführt wird, indem sie tapiRequestMakeCall aufruft. Darüber hinaus können andere Anwendungen anfordern, dass Informationen mit einem bestimmten Aufruf protokolliert werden. Die tapiRequestMakeCall-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, sendet eine LINE_REQUEST Nachricht mit einem Hinweis auf den Modus der Anforderung, der ausstehend ist. Diese Anwendung ist in der Regel die Anrufsteuerungsanwendung des Benutzers.

Als Nächstes ruft die Aufrufsteuerungsanwendung, 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 dann die Anforderung und führt sie aus.

Die Empfängeranwendung wird auch automatisch für alle Anforderungen registriert, wenn sie einen lineShutdown ausführt.