TUISPIDLLCALLBACK

TUISPIDLLCALLBACK is called by the UI DLL to send a private parameter block to the service provider. Each invocation of the callback results in a call to the TSPI_providerGenericDialogData function in the service provider associated with the specified object. The contents of the parameter block are 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.

typedef LONG (CALLBACK * TUISPIDLLCALLBACK) (
    DWORD 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

The dwObjectID parameter is a line device identifier (dwDeviceID). This is used when the callback is invoked during the processing of TUISPI_lineConfigDialog or TUISPI_lineConfigDialogEdit.

TUISPIDLL_OBJECT_PHONEID

The dwObjectID parameter is a phone device identifier (dwDeviceID). This is used when the callback is invoked during the processing of TUISPI_phoneConfigDialog.

TUISPIDLL_OBJECT_PROVIDERID

The dwObjectID parameter is a permament provider identifier. This is used when the callback is invoked during the processing of TUISPI_providerConfig, TUISPI_providerInstall, or TUISPI_providerRemove.

TUISPIDLL_OBJECT_DIALOGINSTANCE

The dwObjectID parameter is an HDRVDIALOGINSTANCE, as returned to the service provider when it sent a LINE_CREATEDIALOGINSTANCE message. This is used when the callback is invoked during the processing of TUISPI_providerGenericDialog.

lpParams

Pointer to a memory area used to hold a parameter block.

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_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.