Platform SDK: Fax Services

FAX_SEND_CALLBACK

The FAX_SEND_CALLBACK function is an application-defined or library-defined callback function that a fax service provider calls to notify the fax service that an outgoing fax call is in progress.

The PFAX_SEND_CALLBACK data type is a pointer to a FAX_SEND_CALLBACK function. FAX_SEND_CALLBACK is a placeholder for an application-defined or library-defined function name.

BOOL CALLBACK FAX_SEND_CALLBACK(
  HANDLE FaxHandle,     // fax handle 
  HCALL CallHandle,     // TAPI call handle 
  DWORD Reserved1,      // reserved; must be zero 
  DWORD Reserved2       // reserved; must be zero 
);

Parameters

FaxHandle
[in] Specifies a fax handle returned by the FaxDevStartJob function.
CallHandle
[in] Specifies a call handle returned by the TAPI 2.x LINE_CALLSTATE message.
Reserved1
[in] This parameter is reserved for future use by Microsoft. It must be set to zero.
Reserved2
[in] This parameter is reserved for future use by Microsoft. It must be set to zero.

Return Values

The fax service returns a value of TRUE to indicate that the active fax operation should continue.

The fax service returns a value of FALSE to indicate that the active fax operation should be terminated. To get extended error information, call GetLastError.

Remarks

The FAX_SEND_CALLBACK callback function provides the fax service with the CallHandle that TAPI assigns. This handle is necessary for TAPI message routing. If the fax service provider does not call FAX_SEND_CALLBACK, it will miss all further call events.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxdev.h.
  Import Library: User-defined.

See Also

Fax Service Provider Application Programming Interface Overview, Fax Service Provider Functions, LINE_CALLSTATE, FaxDevStartJob, FaxDevSend