ITAddress::put_MessageWaiting method (tapi3if.h)

The put_MessageWaiting method sets the status of the message waiting on the address.

Syntax

HRESULT put_MessageWaiting(
  [in] VARIANT_BOOL fMessageWaiting
);

Parameters

[in] fMessageWaiting

Status of message waiting to be set.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_INVALIDARG
The fMessageWaiting parameter is not valid.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT
The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.

Remarks

For programmers familiar with TAPI 2.x: This method turns on and off the flag LINEDEVSTATUSFLAGS_MSGWAIT in the dwDevStatusFlags member of the LINEDEVSTATUS structure by calling lineSetLineDevStatus.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

Address Object

ITAddress

LINEDEVSTATUS

get_MessageWaiting

lineSetLineDevStatus