TSPI_providerGenericDialogData

The TSPI_providerGenericDialogData function delivers to the service provider data that was sent from the UI DLL running in an application context through the TUISPIDLLCALLBACK function. The contents of the memory block pointed to by lpParams is defined by the service provider and UI DLL. The service provider can modify the contents of the parameter block; when this function returns, TAPI copies the modified data back into the original UI DLL parameter block.

Implementation is mandatory if the UI DLL associated with the service provider calls TUISPIDLLCALLBACK.

LONG TSPIAPI TSPI_providerGenericDialogData(
  DWORD_PTR dwObjectID, 
  DWORD dwObjectType,   
  LPVOID lpParams,      
  DWORD dwSize          
);

Parameters

dwObjectID

An object identifer of the type specified by dwObjectType.

dwObjectType

One of the TUISPIDLL_OBJECT_ constants, specifying the type of object identified by dwObjectID:

TUISPIDLL_OBJECT_LINEID

dwObjectID is a line device identifier (dwDeviceID).

TUISPIDLL_OBJECT_PHONEID

dwObjectID is a phone device identifier (dwDeviceID)

TUISPIDLL_OBJECT_PROVIDERID

dwObjectID is a permament provider identifier.

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID is an HDRVDIALOGINSTANCE, as returned to the service provider when it sent a LINE_CREATEDIALOGINSTANCE message.

lpParams

Pointer to a memory area used to hold a parameter block. The contents of this parameter block are specific to the service provider and its associated UI DLL.

dwSize

The size in bytes of the parameter block.

Return Values

Returns zero if successful, or one of these negative error values:

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tspi.h.

See Also

LINE_CREATEDIALOGINSTANCE, TUISPIDLLCALLBACK