lineRemoveProvider-Funktion (tapi.h)

Artikel
08/26/2023

Die funktion lineRemoveProvider entfernt einen vorhandenen Telefoniedienstanbieter aus dem Telefoniesystem.

Syntax

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Parameter

dwPermanentProviderID

Permanenter Anbieterbezeichner des zu entfernenden Dienstanbieters.

hwndOwner

Behandeln Sie ein Fenster, an das alle Dialogfelder angefügt werden, die im Rahmen des Entfernungsprozesses angezeigt werden müssen (z. B. ein Bestätigungsdialogfeld durch die TSPI_providerRemove-Funktion des Dienstanbieters). Kann ein NULL-Wert sein, der angibt, dass jedes während der Funktion erstellte Fenster kein Besitzerfenster haben sollte.

Rückgabewert

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

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

Hinweise

Wenn der Anruf an TSPI_providerRemove erfolgreich ist und das Telefoniesystem zu diesem Zeitpunkt aktiv ist, ruft TAPI lineShutdown und/oder phoneShutdown auf dem Dienstanbieter auf (je nachdem, welche Gerätetypen aktiv sind). Alle Leitungs- oder Telefonhandles, die sich noch von Anwendungen auf zugehörigen Geräten befinden, werden mit LINE_CLOSE - oder PHONE_CLOSE-Nachrichten gewaltsam geschlossen (es ist vorzuziehen, dass Dienstanbieter diese Nachrichten als Teil von TSPI_providerRemove ausgeben, nachdem sie mit dem Benutzer überprüft wurden). Die Geräte, die zuvor unter der Kontrolle dieses Anbieters waren, werden dann als "nicht verfügbar" gekennzeichnet, sodass alle zukünftigen Versuche von Anwendungen, sie per Gerätebezeichner darauf zu verweisen, zu LINEERR_NODRIVER führen.