IFaxServer::RegisterDeviceProvider method (faxcomex.h)
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 |