lineSetLineDevStatus-Funktion (tapi.h)

Die lineSetLineDevStatus-Funktion legt das Zeilengerät status fest. Mit Ausnahme der grundlegenden Parameterüberprüfung handelt es sich um eine direkte Passthrough-Instanz an den Dienstanbieter. Der Dienstanbieter sendet eine LINE_LINEDEVSTATE-Nachricht , um Anwendungen über den neuen Zustand zu informieren, wenn er festgelegt ist. TAPI synthetisiert diese Nachrichten nicht.

Syntax

LONG lineSetLineDevStatus(
  HLINE hLine,
  DWORD dwStatusToChange,
  DWORD fStatus
);

Parameter

hLine

Handle mit dem Leitungsgerät.

dwStatusToChange

Mindestens eine der LINEDEVSTATUSFLAGS_ Konstanten.

fStatus

TRUE (–1), um die angegebene status Bit(s) zu aktivieren, false (0) zum Deaktivieren.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden negativen Fehlerwerte zurück:

LINEERR_INVALLINEHANDLE, LINEERR_INVALLINESTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Anforderungen

Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll