phoneClose-Funktion (tapi.h)

Artikel
08/26/2023

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.