lineGetAgentStatusA-Funktion (tapi.h)
Die lineGetAgentStatus-Funktion ruft die agentbezogene status für die angegebene Adresse ab.
Syntax
LONG lineGetAgentStatusA(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTSTATUS lpAgentStatus
);
Parameter
hLine
Handle für das Open Line-Gerät.
dwAddressID
Adresse auf dem Offenzeilengerät, dessen Agent status abgefragt werden soll. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.
lpAgentStatus
Zeiger auf eine strukturvariable Größe vom Typ LINEAGENTSTATUS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zum Agent status gefüllt. Vor dem Aufruf von lineGetAgentStatus muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben 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.
Hinweise
Hinweis
Der tapi.h-Header 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 | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |