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

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

  • Статья

Содержит сведения о беседе динамического обмена данными (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)

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

CONVCONTEXT

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

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

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

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