TSPI_phoneGetIcon-Funktion (tspi.h)
Die TSPI_phoneGetIcon-Funktion ruft ein gerätespezifisches (oder anbieterspezifisches) Symbol des Diensttelefons ab, das dem Benutzer angezeigt werden soll.
Syntax
LONG TSPIAPI TSPI_phoneGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
Parameter
dwDeviceID
Das Telefongerät, dessen Symbol angefordert wird.
lpszDeviceClass
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die einen Geräteklassennamen identifiziert. Mit dieser Geräteklasse kann der Aufrufer ein bestimmtes Untersymbol auswählen, das für diese Geräteklasse gilt. Dieser Parameter ist optional und kann NULL oder leer bleiben. In diesem Fall wird das Symbol der höchsten Ebene ausgewählt, das dem Telefongerät zugeordnet ist, und nicht ein angegebenes Medienstreamgerät.
lphIcon
Ein Zeiger auf einen Speicherspeicherort, an dem das Handle auf das Symbol zurückgegeben wird.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Hinweise
TSPI_phoneGetIcon bewirkt, dass der Anbieter ein Handle (im DWORD , auf das von lphIcon verwiesen wird) an eine Symbolressource zurückgibt (abgerufen aus dem
LoadIcon-Funktion ), die dem angegebenen Telefon zugeordnet ist. Das Symbolhandle gilt für eine Ressource, die dem Anbieter zugeordnet ist.
Mit dem Parameter lpszDeviceClass kann der Anbieter verschiedene Symbole basierend auf dem Typ des Diensts zurückgeben, auf den der Aufrufer verweist. Die zulässigen Zeichenfolgen sind identisch mit TSPI_phoneGetID. Wenn das Telefon beispielsweise die Comm-API unterstützt, bewirkt die Übergabe von comm/datamodem als lpszDeviceClass , dass der Anbieter ein Symbol zurückgibt, das sich speziell auf die Comm-Gerätefunktionen des Dienstanbieters bezieht. Weitere Informationen zu gängigen Geräteklassen finden Sie unter TSPI-Geräteklassen.
Die Parameter "tapi/phone", "" oder NULL können verwendet werden, um das Symbol für das Telefongerät anzufordern. Ein Anbieter kann wählen, ob er viele Symbole (ausgewählt durch lpszDeviceClass und/oder Telefonnummer), ein einzelnes Symbol (z. B. für den Hersteller, das für alle phoneGetIcon-Anforderungen unabhängig von der ausgewählten lpszDeviceClass zurückgegeben wird) oder keine Symbole unterstützen möchte. In diesem Fall wird das DWORD , auf das von lphIcon verwiesen wird, auf NULL festgelegt. TAPI untersucht das vom Anbieter zurückgegebene Handle, und wenn der Anbieter NULL zurückgibt, ersetzt TAPI ein generisches Telefoniesymbol, das als Ressource in TAPI (das generische Telefonsymbol) enthalten ist.
Wenn der Dienstanbieter keine Symbole unterstützt, kann diese Funktion nicht implementiert werden. In diesem Fall stellt TAPI ein generisches Telefonsymbol für die Anwendung bereit.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |