Skip to content

Latest commit

 

History

History
93 lines (67 loc) · 3.71 KB

nf-faxroute-faxroutedevicechangenotification.md

File metadata and controls

93 lines (67 loc) · 3.71 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:faxroute.FaxRouteDeviceChangeNotification
FaxRouteDeviceChangeNotification function (faxroute.h)
The fax service calls the FaxRouteDeviceChangeNotification function to inform a fax routing extension DLL that a fax device has been removed from the fax server, or that a new fax device has been installed.
FaxRouteDeviceChangeNotification
FaxRouteDeviceChangeNotification function [Fax Service]
_mfax_faxroutedevicechangenotification
fax._mfax_faxroutedevicechangenotification
faxroute/FaxRouteDeviceChangeNotification
fax\_mfax_faxroutedevicechangenotification.htm
Fax
VS|fax|~\fax\faxrouteextapiref_7gry.htm
12/05/2018
FaxRouteDeviceChangeNotification, FaxRouteDeviceChangeNotification function [Fax Service], _mfax_faxroutedevicechangenotification, fax._mfax_faxroutedevicechangenotification, faxroute/FaxRouteDeviceChangeNotification
faxroute.h
Windows
Windows 2000 Professional, Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
FaxRouteDeviceChangeNotification
faxroute/FaxRouteDeviceChangeNotification
c++
APIRef
kbSyntax
UserDefined
FaxRoute.h
FaxRouteDeviceChangeNotification

FaxRouteDeviceChangeNotification function

-description

The fax service calls the FaxRouteDeviceChangeNotification function to inform a fax routing extension DLL that a fax device has been removed from the fax server, or that a new fax device has been installed. Each fax routing extension must export the FaxRouteDeviceChangeNotification function.

-parameters

-param DeviceId [in]

Type: DWORD

Specifies a DWORD variable that is the device identifier of the fax device that has been removed or installed.

-param NewDevice [in]

Type: BOOL

Specifies a Boolean variable that indicates whether the DeviceId parameter identifies a new device. If this parameter is equal to TRUE, the device is a new device. For more information, see the following Remarks section.

-returns

Type: BOOL

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, the fax service calls GetLastError.

-remarks

If the NewDevice parameter is equal to TRUE, it indicates that the fax service detects the installation of a new fax device. The fax routing extension must perform any initialization procedures necessary to enable the extension to route inbound fax transmissions using the new device.

If the NewDevice parameter is equal to FALSE, it indicates that the fax service detects the removal of the fax device identified by the DeviceId parameter. The fax routing extension should perform required cleanup routines at this time.

-see-also

Fax Routing Extension Application Programming Interface Overview

Fax Routing Extension Functions

FaxRouteDeviceEnable