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

Статья
08/23/2023

Регистрирует или отменяет регистрацию имен служб, поддерживаемых сервером динамического обмена данными (DDE). Эта функция заставляет систему отправлять XTYP_REGISTER или XTYP_UNREGISTER транзакции другим работающим клиентским приложениям DDEML .

Синтаксис

HDDEDATA DdeNameService(
  [in]           DWORD idInst,
  [in, optional] HSZ   hsz1,
  [in, optional] HSZ   hsz2,
  [in]           UINT  afCmd
);

Параметры

[in] idInst

Тип: DWORD

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

[in, optional] hsz1

Тип: HSZ

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

[in, optional] hsz2

Тип: HSZ

Защищены; значение должно иметь значение 0L.

[in] afCmd

Тип: UINT

Параметры имени службы. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
DNS_REGISTER 0x0001	Регистрирует имя службы кода ошибки.
DNS_UNREGISTER 0x0002	Отменяет регистрацию имени службы кода ошибки. Если параметр hsz1 имеет значение 0L, все имена служб, зарегистрированные сервером, будут отменены.
DNS_FILTERON 0x0004	Включает фильтрацию запуска имени службы. Фильтр предотвращает получение сервером XTYP_CONNECT транзакций для имен служб, которые он не зарегистрировал. Это параметр по умолчанию для этого фильтра. Если серверное приложение не регистрирует имена служб, оно не может получать XTYP_WILDCONNECT транзакции.
DNS_FILTEROFF 0x0008	Отключает фильтрацию инициации имени службы. Если этот флаг указан, сервер получает транзакцию XTYP_CONNECT всякий раз, когда другое приложение DDE вызывает функцию DdeConnect , независимо от имени службы.

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

Тип: HDDEDATA

Если функция выполняется успешно, она возвращает ненулевое значение. Это значение не является истинным значением HDDEDATA , а просто логическим индикатором успеха. Функция имеет тип HDDEDATA , чтобы обеспечить возможное дальнейшее расширение функции и более сложное возвращаемое значение.

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

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

Имя службы, определяемое параметром hsz1 , должно быть базовым именем (то есть имя не должно содержать сведений, относящихся к экземпляру). Система создает имя конкретного экземпляра и отправляет его вместе с базовым именем во время XTYP_REGISTER и XTYP_UNREGISTER транзакций . Затем получающие приложения могут подключаться к конкретному экземпляру приложения.

Требования


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