GetCommModemStatus-Funktion (winbase.h)

Ruft die Modemsteuerungsregisterwerte ab.

Syntax

BOOL GetCommModemStatus(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpModemStat
);

Parameter

[in] hFile

Ein Handle für das Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.

[out] lpModemStat

Ein Zeiger auf eine Variable, die den aktuellen Zustand der Modemsteuerungsregisterwerte empfängt. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
MS_CTS_ON 0x0010	Das CTS-Signal (Clear-to-Send) ist eingeschaltet.
MS_DSR_ON 0x0020	Das DSR-Signal (data-set-ready) ist eingeschaltet.
MS_RING_ON 0x0040	Das Ringanzeigesignal ist eingeschaltet.
MS_RLSD_ON 0x0080	Das RLSD-Signal (receive-line-signal-detect) ist eingeschaltet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetCommModemStatus-Funktion ist nützlich, wenn Sie die WaitCommEvent-Funktion verwenden, um die CTS-, RLSD-, DSR- oder Ringanzeigesignale zu überwachen. Um zu erkennen, wann diese Signale den Zustand ändern, verwenden Sie WaitCommEvent , und verwenden Sie dann GetCommModemStatus , um den Zustand nach einer Änderung zu bestimmen.

Die Funktion schlägt fehl, wenn die Hardware die Werte des Steuerelementregisters nicht unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile

WaitCommEvent