phoneClose-Funktion (tapi.h)
Die phoneClose-Funktion schließt das angegebene geöffnete Telefongerät.
Syntax
LONG phoneClose(
HPHONE hPhone
);
Parameter
hPhone
Handle mit dem geöffneten Telefongerät, das geschlossen werden soll. Wenn die Funktion erfolgreich ist, ist das Handle nicht mehr gültig.
Rückgabewert
Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
Hinweise
Nachdem das geöffnete Telefongerät erfolgreich geschlossen wurde, sendet die Implementierung eine PHONE_CLOSE Nachricht an die Anwendung. Diese Nachrichten können auch unaufgefordert gesendet werden, weil das Telefongerät irgendwie zurückgefordert wird. Eine Anwendung sollte daher darauf vorbereitet sein, diese unaufgefragten Close-Nachrichten zu verarbeiten. Zum Zeitpunkt des Schließens des Telefongeräts werden alle ausstehenden asynchronen Antworten unterdrückt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |