HP Remote Graphics Software 6.0 User Guide

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.
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 log
●
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 uses 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 90 .
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)
{
HANDLE h;
Remote Application Termination 99