Message_to_clients

c/c++pascalsql

BOOL [cd_]Message_to_clients ([cdp_t cdp,] const char * msg);
function [cd_]Message_to_clients ([cdp : cdp_t;] msg : PChar) : Boolean;
PROCEDURE Message_to_clients (IN msg CHAR(255));

Parametry

msg text zprávy
[cdp kontextová proměnná klienta]

Od verze

6.0, pro SQL od 10.0

Popis

Funkce umožní rozeslat krátkou zprávu všem síťovým klientům připojeným ke stejnému serveru (bez ohledu na otevřenou aplikaci) jako klient, který funkci zavolal. Zpráva se v grafickém vývojovém prostředí objeví jako modální okno.

Funkce neovlivní klienty připojené přes ODBC k tomuto serveru.

Má-li text zprávy obsahovat diaktritku, musí být v kódování UTF-8.

Od verze 9 se význam snížil, neboť klient obvykle není připojen pomocí grafického vývojového prostředí, ale pomocí externího rozhraní (CDK, ODBC apod.), kde se zpráva sama neobjeví. V CDK je ovšem ve třídě TSQL602Connection implementována událost OnServerMessage, která umožňuje naprogramovat zobrazení zprávy i v aplikaci napsané v Delphi.