Функция DdeQueryConvInfo (ddeml.h)

Извлекает сведения о транзакции динамического обмена данными (DDE) и о беседе, в которой происходит транзакция.

Синтаксис

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Параметры

[in] hConv

Тип: HCONV

Дескриптор диалога.

[in] idTransaction

Тип: DWORD

Транзакция. Для асинхронных транзакций этот параметр должен быть идентификатором транзакции, возвращаемым функцией DdeClientTransaction . Для синхронных транзакций этот параметр должен быть QID_SYNC.

[in, out] pConvInfo

Тип: PCONVINFO

Указатель на структуру CONVINFO , которая получает сведения о транзакции и беседе. Элемент cb структуры CONVINFO должен указывать длину буфера, выделенного для структуры.

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

Тип: UINT

Если функция выполняется успешно, возвращаемое значение — это количество байтов, скопированных в структуру CONVINFO .

Если функция завершается сбоем, возвращается значение FALSE.

Функция DdeGetLastError может использоваться для получения кода ошибки, который может иметь одно из следующих значений:

Комментарии

Приложение не должно освобождать дескриптор строки, на который ссылается структура CONVINFO . Если приложение должно использовать один из этих строковых дескрипторов, оно должно вызвать функцию DdeKeepStringHandle , чтобы создать копию дескриптора.

Если параметр idTransaction имеет значение QID_SYNC, элемент hUser структуры CONVINFO связан с диалогом и может использоваться для хранения данных, связанных с диалогом. Если idTransaction является идентификатором асинхронной транзакции, то элемент hUser связан только с текущей транзакцией и действителен только в течение всего периода транзакции.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ddeml.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

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

CONVINFO

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

DdeClientTransaction

DdeConnect

DdeConnectList

DdeKeepStringHandle

DdeQueryNextServer

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

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