Freigeben über


TSPI_providerFreeDialogInstance-Funktion (tspi.h)

Die TSPI_providerFreeDialogInstance-Funktion informiert den Dienstanbieter darüber, dass das mit hdDlgInst verknüpfte Dialogfeld beendet wurde. Nachdem diese Funktion aufgerufen wurde, sollte der Dienstanbieter keine Daten mehr über LINE_SENDDIALOGINSTANCEDATA Nachrichten an das Dialogfeld senden.

Die Implementierung dieser Funktion ist optional. Sie ist nur erforderlich, wenn der Dienstanbieter mithilfe von LINE_CREATEDIALOGINSTANCE spontane Dialogfelder in Anwendungskontexten generiert.

Syntax

LONG TSPIAPI TSPI_providerFreeDialogInstance(
  HDRVDIALOGINSTANCE hdDlgInst
);

Parameter

hdDlgInst

Der undurchsichtige Bezeichner der Zuordnung zwischen dem Dienstanbieter und dem Dialogfeld im Kontext der Anwendung, der als hdDlgInstance-Member in der TUISPICREATEDIALOGINSTANCEPARAMS-Struktur mit der LINE_CREATEDIALOGINSTANCE Meldung übergeben wurde, die das Dialogfeld erstellt hat.

Rückgabewert

Gibt bei erfolgreicher Ausführung null oder einen der folgenden negativen Fehlerwerte zurück:

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tspi.h

Weitere Informationen

LINE_CREATEDIALOGINSTANCE

LINE_SENDDIALOGINSTANCEDATA

TUISPICREATEDIALOGINSTANCEPARAMS