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

Статья
08/23/2023

Устанавливает диалог со всеми серверными приложениями, поддерживающими указанное имя службы и пару имен разделов. Приложение также может использовать эту функцию для получения списка дескрипторов беседы путем передачи функции существующего дескриптора беседы. Библиотека управления Динамического обмена данными удаляет дескрипторы всех завершенных бесед из списка бесед. Результирующий список бесед содержит дескрипторы всех установленных в настоящее время бесед, поддерживающих указанное имя службы и имя темы.

Синтаксис

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

Параметры

[in] idInst

Тип: DWORD

Идентификатор экземпляра приложения, полученный при предыдущем вызове функции DdeInitialize .

[in] hszService

Тип: HSZ

Дескриптор строки, указывающий имя службы серверного приложения, с которым необходимо установить диалог. Если этот параметр равен 0L, система пытается установить диалоги со всеми доступными серверами, поддерживающими указанное имя раздела.

[in] hszTopic

Тип: HSZ

Дескриптор строки, указывающей имя темы, по которой должна быть установлена беседа. Этот дескриптор должен быть создан при предыдущем вызове функции DdeCreateStringHandle . Если этот параметр имеет значение 0L, система попытается установить беседы по всем темам, поддерживаемым выбранным сервером (или серверами).

[in] hConvList

Тип: HCONVLIST

Дескриптор перечисляемого списка бесед. Этот параметр должен иметь значение 0L, если требуется создать новый список бесед.

[in, optional] pCC

Тип: PCONVCONTEXT

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

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

Тип: HCONVLIST

Если функция выполняется успешно, возвращается дескриптор нового списка бесед.

Если функция завершается сбоем, возвращается значение 0L. Дескриптор старого списка бесед больше недействителен.

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

Приложение должно освободить дескриптор списка бесед, возвращаемый функцией DdeConnectList , независимо от того, активны ли какие-либо дескрипторы диалога в списке. Чтобы освободить дескриптор, приложение может вызвать DdeDisconnectList.

Все члены структуры CONVCONTEXT по умолчанию имеют нулевое значение, за исключением cb, указывая размер структуры, и iCodePage, указывая CP_WINANSI (кодовая страница по умолчанию) или CP_WINUNICODE в зависимости от того, была ли версия ANSI или Юникод функции DdeInitialize вызвана клиентским приложением.

Требования

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