TSPI_providerShutdown-Funktion (tspi.h)
Die TSPI_providerShutdown-Funktion fährt den Dienstanbieter herunter. Der Dienstanbieter beendet alle laufenden Aktivitäten und gibt alle zugewiesenen Ressourcen frei.
Syntax
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
Parameter
dwTSPIVersion
Die Version der TSPI-Definition, unter der diese Funktion ausgeführt werden muss. Der Aufrufer kann TSPI_lineNegotiateTSPIVersion oder TSPI_phoneNegotiateTSPIVersion mit dem speziellen dwDeviceID-INITIALIZE_NEGOTIATION verwenden, um eine Version auszuhandeln, die für den Dienstanbieter garantiert akzeptabel ist.
dwPermanentProviderID
Mit diesem Parameter kann der Dienstanbieter ermitteln, welche von mehreren möglichen Instanzen des Dienstanbieters heruntergefahren wird. Der Wert des Parameters ist identisch mit dem Wert, der im Parameter mit demselben Namen in TSPI_providerInit übergeben 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:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.
Hinweise
Der letzte gekoppelte Aufruf dieser Funktion muss der letzte Aufruf einer der TSPI-Funktionen sein, denen TSPI_line oder TSPI_phone als TSPI_lineNegotiateTSPIVersion oder TSPI_phoneNegotiateTSPIVersion vorangestellt ist. Es liegt in der Verantwortung des Aufrufers, dies sicherzustellen.
Diese Funktion sollte immer erfolgreich sein, außer unter außergewöhnlichen Umständen. Die meisten Aufrufer ignorieren wahrscheinlich den Rückgabecode, da sie den aufgetretenen Fehler nicht kompensieren können. Die angegebenen Rückgabewerte sind für Entwicklungsdiagnosezwecke besser geeignet als alles andere.
Es gibt keine direkt entsprechende Funktion in TAPI. In TAPI können mehrere unterschiedliche Nutzungsinstanzen mit einem "Anwendungshandle"-Parameter zum Identifizieren der instance, auf denen betrieben werden soll, hervorragend sein. In TSPI unterstützt die Schnittstellenarchitektur nur eine einzelne Nutzung instance für jeden einzelnen Dienstanbieter.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |