krn.SendMessageToClients

This job sends a message to one or all connected clients.

1. Input Parameters

Name Type Required Description

Name	Type	Required	Description
`Flags`	INT	Yes	Currently not supported — pass `0`.
`Computer`	STRING	Yes	Empty = notify all computers; otherwise: name of the computer
`Instance`	STRING	Yes	Name of the program
`User`	STRING	Yes	Name of the user to be notified
`Message`	STRING	Yes	Type of message
`Info`	STRING	Yes	Message text (programmatic message)
`Text`	STRING	Yes	Message text for the user (e.g. for MessageBox)
`Broadcast`	INT	Yes	`3` = message is sent via all server groups in multi-server systems to users logged in there

Flags

INT

Yes

Currently not supported — pass 0.

Computer

STRING

Yes

Empty = notify all computers; otherwise: name of the computer

Instance

STRING

Yes

Name of the program

User

STRING

Yes

Name of the user to be notified

Message

STRING

Yes

Type of message

Info

STRING

Yes

Message text (programmatic message)

Text

STRING

Yes

Message text for the user (e.g. for MessageBox)

Broadcast

INT

Yes

3 = message is sent via all server groups in multi-server systems to users logged in there

2. Return Value

(INT): 0 = Job successful, otherwise error code.

Over a registered callback channel the server delivers this message as a pushed callback job adm.On<Message> — the job name derives from the Message parameter; it carries Info, Text and internal origprovenience. See krn.GetChannelGUID (section "Callback channel").