Поделиться через

транзакция XTYP_WILDCONNECT

  • Статья

Позволяет клиенту установить диалог по каждой паре имени службы и имени раздела сервера, которые соответствуют указанному имени службы и имени раздела. Функция обратного вызова сервера Динамического обмена данными (DDE) DdeCallback получает эту транзакцию, когда клиент задает имя службы NULL , имя раздела NULL или оба в вызове функции DdeConnect или DdeConnectList .

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)

Параметры

uType

Тип транзакции.

uFmt

Не используется.

hconv

Не используется.

hsz1

Дескриптор имени раздела. Если этот параметр имеет значение NULL, клиент запрашивает беседу по всем именам тем, поддерживаемых сервером.

hsz2

Дескриптор имени службы. Если этот параметр имеет значение NULL, клиент запрашивает диалог со всеми именами служб, поддерживаемыми сервером.

hdata

Не используется.

dwData1

Указатель на структуру CONVCONTEXT , содержащую контекстные сведения для диалога. Если клиент не является приложением DDEML, этот параметр имеет значение 0.

dwData2

Указывает, является ли клиент тем же экземпляром приложения, что и сервер. Если параметр равен 1, клиент является тем же экземпляром. Если параметр равен 0, клиент является другим экземпляром.

Возвращаемое значение

Сервер должен вернуть дескриптор данных, который идентифицирует массив структур HSZPAIR . Массив должен содержать одну структуру для каждой пары "имя службы" и "имя раздела", соответствующую паре "имя службы" и "имя раздела", запрошенной клиентом. Массив должен быть завершен дескриптором строки NULL . Система отправляет XTYP_CONNECT_CONFIRM транзакцию на сервер для подтверждения каждого диалога и передачи дескрипторов диалога серверу. Сервер не получит эти подтверждения, если он указал флаг CBF_SKIP_CONNECT_CONFIRMS в функции DdeInitialize .

Сервер должен вернуть значение NULL , чтобы отклонить транзакцию XTYP_WILDCONNECT .

Комментарии

Эта транзакция фильтруется, если серверное приложение указало флаг CBF_FAIL_CONNECTIONS в функции DdeInitialize .

Сервер не может заблокировать этот тип транзакции; код возврата CBR_BLOCK игнорируется.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Ddeml.h (включая Windows.h)

См. также раздел

Справочные материалы

CONVCONTEXT

DdeConnect

DdeInitialize

HSZPAIR

Основные понятия

Библиотека управления динамического обмена данными