phoneSetButtonInfoW-Funktion (tapi.h)

Die phoneSetButtonInfo--Funktion legt Informationen über die angegebene Schaltfläche auf dem angegebenen Telefon fest.

Syntax

LONG phoneSetButtonInfoW(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Parameter

hPhone

Behandeln Sie das geöffnete Telefongerät. Die Anwendung muss der Besitzer des Telefongeräts sein.

dwButtonLampID

Schaltfläche auf dem Telefongerät.

lpButtonInfo

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

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron oder eine negative Fehlernummer abgeschlossen wird, wenn ein Fehler auftritt. Der dwParam2- Parameter der entsprechenden PHONE_REPLY Nachricht ist Null, wenn die Funktion erfolgreich ist oder eine negative Fehlernummer ist, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Bemerkungen

Anmerkung

Der header tapi.h definiert phoneSetButtonInfo 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-

PHONE_REPLY

ergänzende Telefondienstfunktionen

TAPI 2.2 Referenzübersicht