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

Статья
02/26/2024

Устанавливает диалог с серверным приложением, которое поддерживает указанную пару имени службы и имени раздела. Если существует несколько таких серверов, система выбирает только один из них.

Синтаксис

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

Параметры

[in] idInst

Тип: DWORD

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

[in] hszService

Тип: HSZ

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

[in] hszTopic

Тип: HSZ

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

[in, optional] pCC

Тип: PCONVCONTEXT

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

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

Тип: HCONV

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

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

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

Клиентское приложение не может делать предположения относительно выбранного сервера. Если в параметре hszService указано имя конкретного экземпляра, диалог устанавливается только с указанным экземпляром. Имена служб для конкретного экземпляра передаются функции обратного вызова DDE приложения во время XTYP_REGISTER и XTYP_UNREGISTER транзакций .

Все элементы структуры CONVCONTEXT по умолчанию имеют значение 0, за исключением 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