IFaxDeviceIds::Add method (faxcomex.h)

The IFaxDeviceIds::Add method adds a fax device to the FaxDeviceIds collection, using the device's ID.

Syntax

HRESULT Add(
  [in] long lDeviceId
);

Parameters

[in] lDeviceId

Type: long

A long value that specifies the ID of the fax device to add to the collection.

Return value

Type: HRESULT

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

Remarks

This method can also return remote procedure call (RPC) return values. For more information, see RPC Return Values.

Note  You cannot add devices to the special All Devices routing group. Also, you can only add valid device IDs. You can obtain the valid ID of a device in the FaxDeviceIds collection through the Id property.
 
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

FaxDeviceIds

IFaxDeviceIds

Visual Basic Example