OLE (664410), страница 3

Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 3)

. . .

hConv = DdeConnect(

idInst, // Копия приложения

hszServName, // Идентификатор

service-имени

handle hszSysTopic,// Идентификатор

system-topic-имени

(PCONVCONTEXT) NULL); // Используем контекст

по умолчанию

if( hConv == NULL )

{

MessageBox( hwndParent, "MyServer НЕ доступен!",

(LPSTR) NULL, MB_OK );

return FALSE;

}

. . .

В этом примере функция DdeConnect заставляет DDEML посы-

лать транзакцию вида XTYP_CONNECT в функцию обратного вызова сер-

вера MyServer.

А теперь приведем пример функции обратного вызова сервера,

который обрабатывает транзакцию XTYP_CONNECT и сравнивает свое

зарегистрированное имя с именем, полученным от клиента. Как уже

было отмечено ранее, если они совпадают, то сервер в состоянии

установить диалог с клиентом.

#define CTOPICS 5

HSZ hsz1; // Идентификатор строки,

полученный от DDEML.

HSZ ahszTopics[CTOPICS]; // Массив поддреживаемых

topic имен

int i; // Счетчик цикла

.

. // Для обработки транзакций используем стандартную

ANSI C

. // конструкцию switch --> case --> default.

.

case XTYP_CONNECT:

for (i = 0; i < CTOPICS; i++)

{

if (hsz1 == ahszTopics[i])

return TRUE; // Установка диалога

}

return FALSE; // Topic имя НЕ поддерживается,

диалог запрещен.

.

. // Обработка других типов транзакций.

.

Если сервер возвращает TRUE в ответ на транзакцию

XTYP_CONNECT, DDEML посылает транзакцию вида XTYP_CONNECT_CONFIRM

в функцию обратного вызова данного сервера. Обработав эту тран-

закцию, сервер может получить идендификатор диалога.

Вместо конкретного имени сервера клиент может установить

шаблон диалога путем установки идентификаторов service и topic

имен в NULL при вызове функции DdeConnect.

Если хотя бы один из вышеперечисленных идентификаторов ра-

вен NULL, DDEML посылает транзакцию типа XTYP_WILDCONNECT в фун-

кцию обратного вызова всех активных в данный момент DDE-приложе-

ний (исключения составляют лишь те, кто при вызове соответствую-

щей функции указал флаг фильтрации XTYP_WILDCONNECT).

Любое сервер-приложение должно ответить на данную транзак-

цию и возвратить указатель на массив структур типа HSZPAIR, окан-

чивающийся нулем.

Если сервер-приложение НЕ вызывает функцию DDeNameService

для регистрации собственного service имени в системе и фильтр об-

работки транзакций включен, то сервер НЕ получит транзакцию вида

XTYP_WILDCONNECT.

Вышеописанный массив должен содержать одну структуру для

каждого service и topic имен. DDEML выбирает одну пару из масси-

ва для установления диалога и возвращает его идентификатор клиен-

ту. Затем DDEML посылает серверу транзакцию вида

XTYP_CONNECT_CONFIRM (исключения составляют лишь те серверы, ко-

торые при инициализации установили фильтр обработки транзакций).

Продемонстируем использование транзакции вида XTYP_CONNECT.

#define CTOPICS 2

UINT uType;

HSZPAIR ahszp[(CTOPICS + 1)];

HSZ ahszTopicList[CTOPICS];

HSZ hszServ, hszTopic;

WORD i, j;

if (uType == XTYP_WILDCONNECT)

{

// Сканируем список topic имен и создаем мас-

сив структур типа HSZPAIR

j = 0;

for (i = 0; i < CTOPICS; i++)

{

if (hszTopic == (HSZ) NULL ||

hszTopic == ahszTopicList[i])

{

ahszp[j].hszSvc = hszServ;

ahszp[j++].hszTopic = ahszTopicList[i];

}

}

//

// Последний элемент массива всегда NULL.

//

ahszp[j].hszSvc = NULL;

ahszp[j++].hszTopic = NULL;

//

// Возвращаем дискриптор глобального объекта

// памяти,содержащий структуры типа HSZPAIR.

//

return DdeCreateDataHandle(

idInst, // Копия приложения

(LPBYTE) &ahszp, // Указатель на массив

типа HSZPAIR

sizeof(HSZ) * j, // Длина массива

0, // Начальное смещение

(HSZ) NULL, // item-имя не существует

0, // формат item-имени также

// не существует

0); // Возлагаем все работу

// с массивом на систему

}

Любой сервер или клиент может оборвать диалог в любое вре-

мя путем вызова функции DdeDisconnect. Это означает, что партнер

по обмену данными получает транзакцию типа XTYP_DISCONNECT в фун-

кции обратного вызова (если, конечно, партнер не установил фильтр

обработки транзакций вида CBF_SKIP_DISCONNECTIONS).

Обычно приложение реагирует на транзакцию XTYP_DISCONNECT

вызовом функции DdeQueryInfo для получения информации о прекра-

щенном диалоге. После того, как функция обратного вызова обрабо-

тала транзакцию типа XTYP_DISCONNECT, идентификатор диалога

больше не существует.

Клиентское приложение, которое получает транзакцию типа

XTYP_DISCONNECT в своей функции обратного вызова может попы-

таться возобновить диалог при промощи вызова функции

DdeReconnect. Клиентское приложение может вызывать эту функцию

только находясь внутри своей собственной функции обратного вызова.

Сложный диалог

Клиентское приложение может использовать функцию

DdeConnectList для того, чтобы определить какие сервер-приложе-

ния существуют в системе в данный момент времени.

Клиент обязательно должен описывать service и topic имена,

когда он вызывает эту функцию; это означает, что DDEML должна

послать транзакцию вида XTYP_CONNECT все функции обратного вызо-

ва всех имеющихся в данный момент сервер-приложений, чьи зарегис-

трированные имена совпадают с именами, указанными клиентом (ис-

ключение составляют лишь те серверы, которые фильтруют получае-

мые транзакции).

В добавление к вышесказанному, можно отметить, что клиент,

при вызове функции DdeConnectList, может указать NULL в качестве

service или topic имени, либо же сразу для обоих. Все доступные в

системе серверы, чьи зарегистрированные имена совпадают с имена-

ми, указанными клиентом, отвечают на его запрос. Диалог устанав-

ливается со всеми такими серверами, даже если в системе запущено

одно и тоже сервер-приложение несколько раз.

Клиент может использовать функции DdeQueryNextServer и

DdeQueryConvInfo для того, чтобы понять, какой сервер находится в

списке, полученный при вызове функции DdeConnectList.

DdeQueryNextServer возвращает идентификатор диалога для следующе-

го сервера, находящегося в списке; DdeQueryConvInfo заполняет

структуру CONVINFO информацией о диалоге.

Клиент может сохранить полученные идентификаторы диалогов и

отказаться от просмотра оставшихся серверов в списке.

Приведем пример использования функции DdeConnectList для

установления диалога со всеми серверами, которые поддерживают имя

'system topic', затем будем использовать функции DdeQueryConvInfo

и DdeQueryNextServer для получения их идентификаторов service

имен, одновременно не забывая сохранить последние во временном

буфере.

HCONVLIST hconvList; // Список диалогов

DWORD idInst; // Дискриптор приложения

HSZ hszSystem; // System topic

HCONV hconv = NULL; // Идентификатор диалога

CONVINFO ci; // Информация о диалоге

UINT cConv = 0; // Количество идентификаторов

диалогов

HSZ *pHsz, *aHsz; // Указатель на идентификатор

строки

// Присоединяемся ко всем серверам, поддерживающим

// System topic.

hconvList = DdeConnectList(idInst, NULL, hszSystem,

NULL, NULL);

// Вычисляем количество серверов в списке.

while((hconv = DdeQueryNextServer(hconvList,hconv))

!= NULL)

cConv++;

// Выделяем буфер для сохранения идентификаторов строк.

hconv = NULL;

aHsz = (HSZ *) LocalAlloc(LMEM_FIXED, cConv * sizeof(HSZ));

// Копируем идентификатор строки в буфер.

pHsz = aHsz;

ile((hconv = DdeQueryNextServer(hconvList,hconv)) != NULL)

{

DdeQueryConvInfo(hconv, QID_SYNC, (PCONVINFO) &ci);

DdeKeepStringHandle(idInst, ci.hszSvcPartner);

*pHsz++ = ci.hszSvcPartner;

}

.

. // Используем идентификатор: 'общаемся' с сервером.

.

// Освобождаем память и прекращаем диалог.

LocalFree((HANDLE) aHsz);

DdeDisconnectList(hconvList);

Приложение может оборвать индивидуальный диалог, находящий-

ся в списке диалогов путем вызова функции DdeDisconnect; приложе-

ние может оборвать все диалоги, находящиеся в списке путем вызо-

ва функции DdeDisconnectList.

Обе вышеуказанные функции указывают DDEML о необходимости

посылки транзакции вида XTYP_DISCONNECT во все функции партнеров

по диалогу данного приложения (в случае использования функции

DdeDisconnectList будет посылаться транзакция XTYP_DISCONNECT для

каждого элемента в списке диалогов).

Обмен данными между приложениями

Так как DDE использует области памяти для передачи данных

из одного приложения в другое, DDEML обеспечивает конечного прог-

раммиста функциями, при помощи которых DDE-приложения могут соз-

давать и обрабатывать DDE-объекты.

Весь спектр транзакций, который вызывает обмен данными,

требует от приложения, экспортирующего их, создания некоторого

буфера, содержащего эти данные, а затем вызова функции

DdeCreateDataHandle.

Эта функция создает DDE-объект, копирует данные из буфера в

этот объект и возвращает идентификатор данных для данного прило-

жения.

Идентификатор данных-это двойное слово, которое использует

DDEML для обеспечения доступа к данным в DDE-объекте.

Для того, чтобы разделять данные в DDE-объекте, приложение

передает идентификатор данных DDEML, а затем DDEML передает его в

функцию обратного вызова приложения, получающего данные.

В нижеприведенном примере показано, как создать DDE-объект

и получить его идентификатор. В процессе обработки транзакции ти-

па XTYP_ADVREQ, функция обратного вызова конвертирует текущее

время в ASCII строку, копирует строку в вспомогательный буфер, а

затем создает DDE-объект, содержащий вышеуказанную строку. Фун-

кция обратного вызова возвращает идентификатор DDE-объекта DDEML,

которая передает этот идентификатор клиентскому приложению.

typedef struct tagTIME

{

INT hour; // 0 - 11 формат времени для

часов.

INT hour12; // 12-ой формат.

INT hour24; // 24-ой формат.

INT minute;

INT second;

INT ampm; // 0 --> AM , 1 --> PM

} TIME;

HDDEDATA EXPENTRY DdeCallback

(uType, uFmt, hconv, hsz1, hsz2, hdata,

dwData1, dwData2)

UINT uType;

UINT uFmt;

HCONV hconv;

HSZ hsz1;

HSZ hsz2;

HDDEDATA hdata;

DWORD dwData1;

DWORD dwData2;

{

CHAR szBuf[32];

switch (uType)

{

case XTYP_ADVREQ:

case XTYP_REQUEST:

if ((hsz1 == hszTime && hsz2 == hszNow)

&& (uFmt == CF_TEXT))

{

// Копируем строку в буфер.

itoa(tmTime.hour, szBuf, 10);

lstrcat(szBuf, ":");

if (tmTime.minute < 10)

lstrcat(szBuf, "0");

itoa(tmTime.minute,

&szBuf[lstrlen(szBuf)], 10);

lstrcat(szBuf, ":");

if (tmTime.second < 10)

strcat(szBuf, "0");

itoa(tmTime.second,

&szBuf[lstrlen(szBuf)], 10);

szBuf[lstrlen(szBuf)] = '\0';

// Создаем глобальный объект и

// возвращаем его идентификатор

return (DdeCreateDataHandle(

idInst, // копия

приложения

(LPBYTE) szBuf, // исходный

буфер

lstrlen(szBuf) + 1,

0, // смещение

от его начала

hszNow, // item-имя

CF_TEXT, // формат

почтого ящика

0));

}

else return (HDDEDATA) NULL;

.

. // Обработка других типов транзакций.

.

}

}

Клиентское приложение получает указатель на DDE-объект пу-

тем передачи идентификатора данных функции DdeAccessData. Указа-

тель, возвращаемый этой функцией, обеспечивает доступ к данным в

формате 'ТОЛЬКО НА ЧТЕНИЕ'. Клиент должен просмотреть полученные

данные при помощи этого указателя и вызвать функцию

DdeUnaccessData для его уничтожения. Клиент может скопировать по-

лученные данные в заранее приготовленный буфер посредством вызо-

ва функции DdeGetData.

В следующем примере мы получим указатель на DDE-объект,

сохраним его в параметре hData, скопируем содержимое во времен-

ный буфер и уничтожим указатель:

HDDEDATA hdata;

LPBYTE lpszAdviseData;

DWORD cbDataLen;

DWORD i;

char szData[32];

. . .

Характеристики

Список файлов реферата