IFaxServerNotify::OnDeviceStatusChange method
Applies to: desktop apps only
The fax service calls the IFaxServerNotify::OnDeviceStatusChange method when there is a change to a fax device status.
HRESULT OnDeviceStatusChange(
IFaxServer *pFaxServer,
long lDeviceId,
VARIANT_BOOL bPoweredOff,
VARIANT_BOOL bSending,
VARIANT_BOOL bReceiving,
VARIANT_BOOL bRinging
);
pFaxServer
Type: IFaxServer*A FaxServer object.
lDeviceId
Type: longLong value that contains the ID of the device for which the status has changed.
bPoweredOff
Type: VARIANT_BOOLBoolean value. If this parameter is equal to TRUE, the fax device is currently offline and unavailable for sending and receiving faxes. If this parameter is equal to FALSE, the fax device is online and available.
bSending
Type: VARIANT_BOOLBoolean value. If this parameter is equal to TRUE, the fax device is sending faxes. If this parameter is equal to FALSE, the fax device is not sending faxes.
bReceiving
Type: VARIANT_BOOLBoolean value. If this parameter is equal to TRUE, the fax device is receiving faxes. If this parameter is equal to FALSE, the fax device is not receiving faxes.
bRinging
Type: VARIANT_BOOLBoolean value. If this parameter is equal to TRUE, the fax device is ringing. If this parameter is equal to FALSE, the fax device is not ringing.
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
To implement this functionality in Visual Basic, select and implement the appropriate event procedure. For an example, see Registering for Fax Events.
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Header |
FaxComex.h |
DLL |
Fxscomex.dll |
Build date: 5/5/2012