Stop Host Notification

Stop Host Notification – Function 25

This function disables notifying your Windows HLLAPI application of changes in the Host session presentation space or Operation Information Area (OIA).

Prerequisite functions

Start Host Notification (function 23)

Function call

WinHLLAPI(STOPHOSTNOTIFICATION,lpbyString,lpwLength,lpwReturnnCode)

Call parameters

Parameter	Description
Data String	Short name session ID of the desired Host session, or space or null for the current Host session.
Data Length	NA (length of 1 is implied).
PS Position	NA

Return code

Code	Description
WHLLOK	Host notification disabled (function successful).
WHLLNOTCONNECTED	The specified Host session is invalid.
WHLLSYSERROR	The function failed due to a system error.
WHLLNOTAVAILABLE	Start Host Notification (function 23) has not been called prior to this function for the specified Host session.

Remarks

Once Host notification has been disabled, Query Host Update (function 24) can no longer determine updates to the Host session, and Host events do not satisfy Pause (function 18).