Структура CONVINFO (ddeml.h)

Статья
08/23/2023

Содержит сведения о беседе динамического обмена данными (DDE).

Синтаксис

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Члены

cb

Тип: DWORD

Размер структуры в байтах.

hUser

Тип: DWORD_PTR

Данные, определяемые приложением.

hConvPartner

Тип: HCONV

Дескриптор партнерского приложения в беседе DDE. Этот элемент равен нулю, если партнер не зарегистрировал себя (используя функцию DdeInitialize ) для выполнения вызовов функций DDEML. Приложение не должно передавать этот элемент ни одной функции DDEML, кроме DdeQueryConvInfo.

hszSvcPartner

Тип: HSZ

Дескриптор имени службы партнерского приложения.

hszServiceReq

Тип: HSZ

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

hszTopic

Тип: HSZ

Дескриптор имени запрошенного раздела.

hszItem

Тип: HSZ

Дескриптор имени запрошенного элемента. Этот член зависит от транзакции.

wFmt

Тип: UINT

Формат передаваемых данных. Этот член зависит от транзакции.

wType

Тип: UINT

Тип текущей транзакции. Этот член зависит от транзакции; Это может быть одно из следующих значений.

Значение	Значение
XTYP_ADVDATA 0x4010	Сообщает клиенту о поступлении данных с сервера.
XTYP_ADVREQ 0x2022	Запрашивает сервер для отправки обновленных данных клиенту во время цикла консультирования. Эта транзакция возникает, когда сервер вызывает DdePostAdvise.
XTYP_ADVSTART 0x1030	Запрашивает сервер для запуска цикла консультирования с клиентом.
XTYP_ADVSTOP 0x8040	Уведомляет сервер о том, что цикл рекомендаций останавливается.
XTYP_CONNECT 0x1062	Запрашивает сервер для установления диалога с клиентом.
XTYP_CONNECT_CONFIRM 0x8072	Уведомляет сервер о том, что установлен диалог с клиентом.
XTYP_DISCONNECT 0x80C2	Уведомляет сервер о завершении диалога.
XTYP_EXECUTE 0x4050	Запрашивает сервер для выполнения команды, отправленной клиентом.
XTYP_MONITOR 0x80F2	Уведомляет приложение, зарегистрированное как APPCMD_MONITOR , что передаются данные DDE.
XTYP_POKE 0x4090	Запрашивает у сервера прием нежелательных данных от клиента.
XTYP_REGISTER 0x80A2	Уведомляет другие приложения DDEML о том, что сервер зарегистрировал имя службы.
XTYP_REQUEST 0x20B0	Запрашивает сервер для отправки данных клиенту.
XTYP_UNREGISTER 0x80D2	Уведомляет другие приложения DDEML о том, что сервер отменил регистрацию имени службы.
XTYP_WILDCONNECT 0x20E2	Запрашивает сервер для установки нескольких диалогов с тем же клиентом.
XTYP_XACT_COMPLETE 0x8080	Уведомляет клиента о завершении асинхронной транзакции данных.

wStatus

Тип: UINT

Состояние текущей беседы. Этот элемент может иметь одно или несколько из следующих значений.

Значение	Значение
ST_ADVISE 0x0002	Выполняется одна или несколько ссылок.
ST_BLOCKED 0x0008	Беседа заблокирована.
ST_BLOCKNEXT 0x0080	Беседа будет заблокирована после вызова следующего обратного вызова.
ST_CLIENT 0x0010	Дескриптор con0x0010versation, передаваемый функции DdeQueryConvInfo , является дескриптором на стороне клиента. Если дескриптор равен нулю, дескриптор диалога, передаваемый в функцию DdeQueryConvInfo , является дескриптором на стороне сервера.
ST_CONNECTED 0x0001	Беседа подключена.
ST_INLIST 0x0040	Беседа является членом списка бесед.
ST_ISLOCAL 0x0004	Обе стороны беседы используют DDEML.
ST_ISSELF 0x0100	Обе стороны диалога используют один и тот же экземпляр DDEML.
ST_TERMINATED 0x0020	Диалог был прерван партнером.

wConvst

Тип: UINT

Состояние беседы. Этот элемент может быть одним из следующих значений.

Значение	Значение
XST_ADVACKRCVD 13	Транзакция с рекомендацией только что завершена.
XST_ADVDATAACKRCVD 16	Транзакция с данными рекомендаций только что завершена.
XST_ADVDATASENT 15	Данные рекомендаций отправлены и ожидают подтверждения.
XST_ADVSENT 11	Транзакция с рекомендацией ожидает подтверждения.
XST_CONNECTED 2	В беседе нет активных транзакций.
XST_DATARCVD 6	Запрошенные данные только что получены.
XST_EXECACKRCVD 10	Транзакция выполнения только что завершена.
XST_EXECSENT 9	Транзакция выполнения ожидает подтверждения.
XST_INCOMPLETE 1	Последняя транзакция завершилась сбоем.
XST_INIT1 3	Состояние середины запуска 1.
XST_INIT2 4	Состояние середины запуска 2.
XST_NULL 0	Состояние предварительного запуска.
XST_POKEACKRCVD 8	Транзакция только что завершена.
XST_POKESENT 7	Транзакция poke ожидает подтверждения.
XST_REQSENT 5	Транзакция запроса ожидает подтверждения.
XST_UNADVACKRCVD 14	Незаверченная транзакция только что завершена.
XST_UNADVSENT 12	Транзакция unadvise ожидает подтверждения.

wLastError

Тип: UINT

Значение ошибки, связанное с последней транзакцией.

hConvList

Тип: HCONVLIST

Дескриптор списка бесед, если дескриптор текущей беседы находится в списке бесед. Этот член имеет значение NULL , если беседа отсутствует в списке бесед.

ConvCtxt

Тип: CONVCONTEXT

Контекст беседы.

hwnd

Тип: HWND

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

hwndPartner

Тип: HWND

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	ddeml.h (включая Windows.h)