Platform SDK: TAPI

ITAddress::get_MessageWaiting

Determines if the address has a message waiting.

HRESULT get_MessageWaiting(
  VARIANT_BOOL *pfMessageWaiting
);

Parameters

pfMessageWaiting
[out, retval] If VARIANT_TRUE is returned, a message is waiting; if VARIANT_FALSE is returned, no message is waiting.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_POINTER The pfMessageWaiting parameter is not a valid pointer.

Remarks

In TAPI 2.x, this maps to the flag LINEDEVSTATUSFLAGS_MSGWAIT being set or not in the member dwDevStatusFlags from the structure LINEDEVSTATUS.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITAddress, put_MessageWaiting, Address Object, LINEDEVSTATUS