_IFaxServerNotify2::OnNewCall method (faxcomex.h)

The fax service calls the IFaxServerNotify2::OnNewCall method when there is a new incoming fax call.

Syntax

HRESULT OnNewCall(
  IFaxServer2 *pFaxServer,
  long        lCallId,
  long        lDeviceId,
  BSTR        bstrCallerId
);

Parameters

pFaxServer

Type: IFaxServer2*

A IFaxServer2 object.

lCallId

Type: long

Long value that specifies the call's ID.

lDeviceId

Type: long

Long value that specifies the device ID of the device receiving the new incoming fax call.

bstrCallerId

Type: long

Null-terminated string that identifies the calling device for the new incoming fax call.

Return value

Type: HRESULT

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

Remarks

To implement this functionality in Visual Basic, select and implement the appropriate event procedure. For an example, see Registering for Fax Events.

Requirements

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

See also

IFaxServerNotify2