Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineGetRequest--Funktion ruft die nächste By-Proxy-Anforderung für den angegebenen Anforderungsmodus ab.
Syntax
LONG lineGetRequestW(
HLINEAPP hLineApp,
DWORD dwRequestMode,
LPVOID lpRequestBuffer
);
Parameter
hLineApp
Der Anwendungsnutzungshandle für den Zeilenteil von TAPI.
dwRequestMode
Ein Anforderungstyp, der abgerufen werden soll. Beachten Sie, dass dwRequestMode- nur ein Bit festlegen kann. Dieser Parameter verwendet eine und 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ängt vom Anforderungsmodus ab. Der vom Anwendung zugewiesene Puffer wird davon ausgegangen, dass die Anforderung ausreichend groß ist.
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 auftritt, 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.
Bemerkungen
Eine Telefonie-fähige Anwendung kann anfordern, dass ein Anruf in seinem Namen getätigt wird, indem er tapiRequestMakeCallaufruft. Diese Anforderungen werden von TAPI in die Warteschlange gestellt, und die Anwendung mit der höchsten Priorität, die für die Verarbeitung der Anforderung registriert wurde, wird eine LINE_REQUEST Nachricht mit Dem Hinweis auf den Modus der ausstehenden Anforderung gesendet. In der Regel ist diese Anwendung die Anrufsteuerungsanwendung des Benutzers. Die meldung LINE_REQUEST weist darauf hin, dass null oder mehr Anfragen für die registrierte Bewerbung ausstehen können; 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 Aufrufsteuerungsanwendung, die diese Nachricht empfängt, lineGetRequestauf, wobei der Anforderungsmodus und ein Puffer angegeben werden, der groß genug ist, um die Anforderung zu enthalten. Die Aufrufsteuerungsanwendung interpretiert und führt die Anforderung aus.
Nach der Ausführung von lineGetRequestlöscht TAPI die Anforderung aus der internen Warteschlange und stellt Platz für eine nachfolgende Anforderung zur Verfügung. Es ist daher möglich, dass eine neue LINE_REQUEST Nachricht sofort nach 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 durch einen bestimmten Mechanismus zu behandeln; Beispielsweise durch Notieren der zusätzlichen LINE_REQUEST und Verzögern einer nachfolgenden lineGetRequest-, bis die Verarbeitung der vorherigen Anforderung abgeschlossen ist, indem sie die nachfolgende Anforderung und den nachfolgenden Puffer nach Bedarf oder auf andere geeignete Weise abrufen.
Die nachfolgenden LINE_REQUEST sollten nicht ignoriert werden, da sie nicht von TAPI wiederholt wird.
Anmerkung
Der header tapi.h definiert lineGetRequest 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 |