ipsend.ReportStatus

[This is preliminary documentation and subject to change.]

The ReportStatus property specifies whether an enhancement control running in the same process as ipsend sends status reports to the ipsend object.

Syntax

object.ReportStatus = [ lStatus ]
 

Parts

object

Object expression that resolves to an ipsend object.

lStatus

Long that specifies whether enhancement controls report status. If this value is non-zero, the controls report status. If this value is zero, they do not. The default value is 0.

Remarks

The ReportStatus property is set by applications that need to determine the asynchronous state of an enhancement control. For example, a stream player could set this property in order to be able to track the status of the enhancement control it hosts to playback the stream.

If your application enables status reporting by setting ReportStatus to a non-zero value, it must disable status reporting before it releases the ipsend object. Otherwise, the ipsend object will not exit memory because of circular references to an internal enhancement status object.

If you have multiple enhancement controls running in the same process as ipsend, the ipsend object cannot distinguish between status change notifications for each enhancement control. To avoid confusion, it is recommended that you have only one enhancement control running in-process with ipsend.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in ipenhsnd.idl.
  Import Library: Included as a resource in ipenhsnd.dll.
  Unicode: Yes.

See Also

ipsend.Status, ipsend.StatusChanged, Monitoring the Status of an Enhancement Control, Enhancement Control