На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

DdeNameService



The DdeNameService function registers or unregisters the service names a dynamic data exchange (DDE) server supports. This function causes the system to send XTYP_REGISTER or XTYP_UNREGISTER transactions to other running Dynamic Data Exchange Management Library (DDEML) client applications.

A server application should call this function to register each service name that it supports and to unregister names it previously registered but no longer supports. A server should also call this function to unregister its service names just before terminating.

HDDEDATA DdeNameService(

DWORD idInst, // instance identifier
HSZ hsz1, // handle to service name string
HSZ hsz2, // reserved
UINT afCmd // service name flags
);


Parameters

idInst

Specifies the application instance identifier obtained by a previous call to the DdeInitialize function.

hsz1

Identifies the string that specifies the service name the server is registering or unregistering. An application that is unregistering all of its service names should set this parameter to 0L.

hsz2

Reserved; should be set to 0L.

afCmd

Specifies the service name flags. This parameter can be one of the following flags:

Flag Meaning
DNS_REGISTER Registers the error code service name.
DNS_UNREGISTER Unregisters the error code service name. If the hsz1 parameter is 0L, all service names registered by the server will be unregistered.
DNS_FILTERON Turns on service name initiation filtering. The filter prevents a server from receiving XTYP_CONNECT transactions for service names it has not registered. This is the default setting for this filter.
If a server application does not register any service names, the application cannot receive XTYP_WILDCONNECT transactions.
DNS_FILTEROFF Turns off service name initiation filtering. If this flag is specified, the server receives an XTYP_CONNECT transaction whenever another DDE application calls the DdeConnect function, regardless of the service name.


Return Values

If the funcion succeeds, it returns a nonzero value. That value is not a true HDDEDATA value, merely a Boolean indicator of success. The function is typed HDDEDATA to allow for possible future expansion of the function and a more sophisticated return value.
If the function fails, the return value is 0L.

Errors

The DdeGetLastError function can be used to get the error code, which may be one of the following values:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_DLL_USAGE
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR

Remarks

The service name identified by the hsz1 parameter should be a base name (that is, the name should contain no instance-specific information). The system generates an instance-specific name and sends it along with the base name during the XTYP_REGISTER and XTYP_UNREGISTER transactions. The receiving applications can then connect to the specific application instance.

See Also

DdeConnect, DdeConnectList, DdeInitialize, XTYP_REGISTER, XTYP_UNREGISTER


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DdeNameService



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

Приложение сервера должно называть эту функцию, чтобы регистрировать каждое имя услуги, что оно поддерживает и в unregister имена это прежде зарегистрировало но больше опоры. Сервер должен также называть эту функцию в unregister имена услуги точные перед завершением.

HDDEDATA DdeNameService(

DWORD idInst, // ИДЕНТИФИКАТОР примера HSZ hsz1, // ручка, чтобы обслуживать строку имени HSZ hsz2, // зарезервировавшее флаги имени услуги UINT afCmd //
);


Параметры

idInst

Определяет прикладной идентификатор примера полученный предшествующим вызовом в функцию DdeInitialize.

hsz1

Идентифицирует строку, которая определяет имя услуги, что сервер регистрирует или unregistering. Приложение, которое unregistering всю услугу, имена должны устанавливать этот параметр в 0L.

hsz2

Зарезервированное; должно быть установлено в 0L.

afCmd

Определяет флаги имени услуги. Этот параметр может быть одним из следующего флагов:

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


Обратные Величины

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

Ошибки

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

Замечания

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

Смотри Также

DdeConnect, DdeConnectList, DdeInitialize, XTYP_REGISTER, XTYP_UNREGISTER


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz