HP Remote Graphics Software 5.4.0 User Guide

10.4 Sample Agent
The sample Windows agent presented below monitors the HPRemote event log and interprets its events.
Comments are included in the agent code showing where additional code would be added to
determine if the number of primary users has dropped to zero. If so, further code can be added to
terminate applications on the Sender. A number of design issues for the Windows agent are described
in the previous section.
The sample code is a fixed-polling Windows agent that reads and interprets the HPRemote event log.
The agent uses two functions:
1.
processEvent(eventServer, eventSource, dwEventNum)
◦
open event log, read event dwEventNum, close event logTo
◦
if a valid read, process recognized EventIDs, then return
2.
monitorEvents(eventServer, eventSource, seconds)
◦
for a finite number of seconds (or infinite if seconds <= 0) do
◦
open event log, read log length, close event log
◦
if log has changed, processEvent(), else sleep for X ms.
To properly use the function monitorEvents(...), the following strings must be defined in the function call:
●
LPCTSTR eventServer: if string is defined as "\\\\yourservername", then the log is stored on a
remote server - if the string is empty (NULL), then the log is stored locally (note that four backlashes
compiles to two in a string constant).
●
LPCTSTR eventSource: the name of the target event generator, e.g., rgreceiver
The sample agent use Microsoft event logging functions such as OpenEventLog, ReadEventLog, and
CloseEventLog. For information on these functions, refer to the Event Logging Functions link highlighted
in the figure used in
Additional information on event logging on page 185 .
The sample agent is listed below. Where noted, user-specific code should be added. The agent header
file, RGSenderEvents.h, is installed with the RGS Sender and is located at:
C:\Program Files\Hewlett-Packard\Remote Graphics Sender\include\RGSenderEvents.h
#include <windows.h>
#include <stdio.h>
#include "RGSenderEvents.h"
#define BUFFER_SIZE 1024 // safe EVENTLOGRECORD size for now
#define EVENT_SERVER NULL // remote server = "\\\\nodename"; local = NULL
#define EVENT_SRC "rgsender" // specifies specific event name source in // HPRemote
BOOL processEvent(LPCTSTR eventServer, LPCTSTR eventSource, DWORD dwEventNum)
194 Chapter 10 Remote Application Termination ENWW