Edit

IFaxServer::RegisterDeviceProvider method (faxcomex.h)

  • Article

The IFaxServer::RegisterDeviceProvider method registers a fax service provider (FSP) with the fax service. Registration takes place after the fax service restarts.

Syntax

HRESULT RegisterDeviceProvider(
  BSTR bstrGUID,
  BSTR bstrFriendlyName,
  BSTR bstrImageName,
  BSTR TspName,
  long lFSPIVersion
);

Parameters

bstrGUID

Type: BSTR

Null-terminated string that contains the GUID that uniquely identifies the FSP that is registering.

bstrFriendlyName

Type: BSTR

Null-terminated string that contains the user-friendly name to display for the FSP that is registering.

bstrImageName

Type: BSTR

Null-terminated string that contains the fully qualified path and file name of the FSP DLL.

TspName

Type: BSTR

Null-terminated string that contains the name of the telephony service provider associated with the devices for the FSP.

lFSPIVersion

Type: long

A long value that indicates the version of the FSP. Should be equal to 0x00010000.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Only an administrator can register a FSP.

To use this method, a user must have the farMANAGE_CONFIG access right.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header faxcomex.h
DLL Fxscomex.dll

See also

FaxServer

IFaxServer