транзакция XTYP_CONNECT
Клиент использует транзакцию XTYP_CONNECT для установления беседы. Функция обратного вызова сервера dynamic Data Exchange (DDE) DdeCallback получает эту транзакцию, когда клиент указывает имя службы, которое поддерживает сервер (и имя раздела, которое не равно NULL) в вызове функции DdeConnect.
#define XCLASS_BOOL 0x1000
#define XTYPF_NOBLOCK 0x0002
#define XTYP_CONNECT (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)
Параметры
-
uType
-
Тип транзакции.
-
uFmt
-
Не используется.
-
hconv
-
Не используется.
-
hsz1
-
Дескриптор имени раздела.
-
hsz2
-
Дескриптор имени службы.
-
hdata
-
Не используется.
-
dwData1
-
Указатель на структуру CONVCONTEXT , содержащую сведения о контексте диалога. Если клиент не является приложением DDEML, этот параметр равен 0.
-
dwData2
-
Указывает, является ли клиент тем же экземпляром приложения, что и сервер. Если параметр равен 1, клиент является тем же экземпляром. Если параметр равен 0, клиент является другим экземпляром.
Возвращаемое значение
Функция обратного вызова сервера должна возвращать значение TRUE , чтобы разрешить клиенту устанавливать беседу с указанным именем службы и парой имен раздела, или функция должна возвращать значение FALSE , чтобы запретить беседу. Если функция обратного вызова возвращает значение TRUE и беседа успешно установлена, система передает дескриптор диалога серверу, выдавая XTYP_CONNECT_CONFIRM транзакцию функции обратного вызова сервера (если сервер не указал флаг CBF_SKIP_CONNECT_CONFIRMS в функции DdeInitialize ).
Комментарии
Эта транзакция фильтруется, если серверное приложение указало флаг CBF_FAIL_CONNECTIONS в функции DdeInitialize .
Серверу не удается заблокировать этот тип транзакции; код возврата CBR_BLOCK игнорируется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
См. также раздел
-
Ссылки
-
Основные понятия