lineGetAgentStatusA-Funktion (tapi.h)

Artikel
03/04/2024

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.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass der Arbeitsspeicher überschrieben wird. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .

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.