phoneGetButtonInfoW-Funktion (tapi.h)

Die phoneGetButtonInfo Funktion gibt Informationen zur angegebenen Schaltfläche zurück.

Syntax

LONG phoneGetButtonInfoW(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Parameter

hPhone

Behandeln Sie das geöffnete Telefongerät.

dwButtonLampID

Schaltfläche auf dem Telefongerät.

lpButtonInfo

Zeiger auf eine variabel angepasste Struktur des Typs PHONEBUTTONINFO. Diese Datenstruktur beschreibt den Modus und die Funktion und stellt zusätzlichen beschreibenden Text bereit, der der Schaltfläche entspricht.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Bemerkungen

Anmerkung

Der tapi.h-Header definiert phoneGetButtonInfo 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

Siehe auch

PHONEBUTTONINFO-

ergänzende Telefondienstfunktionen

TAPI 2.2 Referenzübersicht