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.