Platform SDK: Fax Services

IFaxServer::put_ServerMapiProfile

The IFaxServer::put_ServerMapiProfile method changes the ServerMapiProfile property for a FaxServer object. The ServerMapiProfile property is a null-terminated string that contains the MAPI user profile that the fax server uses for routing incoming fax transmissions.

Visual Basic Reference

HRESULT put_ServerMapiProfile(
  BSTR newVal  // new value for MAPI profile string
);

Parameters

newVal
[in] Specifies the new value to assign to the ServerMapiProfile property. The fax server uses the profile for routing incoming fax transmissions and for sending delivery reports (DRs) and non-delivery reports (NDRs).

Return Values

Returns an HRESULT value indicating success or failure. If the method succeeds, it returns S_OK. Otherwise, it returns a COM-defined error code.

You should not check directly for success or failure. Use the COM SUCCEEDED and FAILED macros instead.

Remarks

For more information, see Enabling MAPI Functionality in a Fax Client Application.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxcom.h.
  Import Library: Included as a resource in faxcom.dll.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxServer, IFaxServer::get_ServerMapiProfile