lineGetAgentStatusA-Funktion (tapi.h)
Die lineGetAgentStatus- Funktion ruft den agentbezogenen Status für die angegebene Adresse ab.
Syntax
LONG lineGetAgentStatusA(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTSTATUS lpAgentStatus
);
Parameter
hLine
Behandeln des offenen Leitungsgeräts.
dwAddressID
Adresse auf dem offenen Line-Gerät, dessen Agentstatus abgefragt werden soll. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.
lpAgentStatus
Zeiger auf eine variabel angepasste Struktur des Typs LINEAGENTSTATUS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Agentstatusinformationen gefüllt. Vor dem Aufrufen von lineGetAgentStatus-muss die Anwendung die dwTotalSize Mitglied dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der tapI für die Rückgabe von Informationen zur Verfügung steht.
Rückgabewert
Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird; andernfalls einer der folgenden negativen Fehlerwerte:
LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.
Bemerkungen
Anmerkung
Der header tapi.h definiert lineGetAgentStatus 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 |