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

Статья
02/26/2024

Извлекает сведения о транзакции динамического обмена данными (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