Отправляет данные между клиентом и приложениями-серверами в сеансе динамического обмена данными (DDE).

DDEPoke(nChannelNumber, cItemName, cDataSent
   [, cDataFormat [, cUDFName]])

Параметры

nChannelNumber

Определяет номер канала для пересылки данных прикладной программы. Если этот канал - канал сервера, DDEPoke( ) посылает данные в ответ на запрос, или предварительно посылает уведомление или устанавливает автоматическое соединение.
cItemName

Определяет имя пункта, которому посылают данные. Имя пункта является специфическим для приложения и должно быть им понято. Например, Microsoft Excel поддерживает R1C1 как допустимое имя пункта, которое ссылается к первой ячейке в рабочем листе.
cDataSent

Определяет данные, посланные на имя пункта, указанное в cItemName .
cDataFormat

Определяет формат, используемый, чтобы послать данные. Заданный по умолчанию формат - CF_TEXT. В этом формате, поля разграничены символами табуляции, а записи разграничены символами перевода каретки и перевода строки.
cUDFName

Разрешает асинхронную передачу данных. Если cUDFName опущен, клиент ждет в течение периода, указанного DDESetOption( ) . Если Вы определяете имя пользовательской функции параметром cUDFName , выполнение программы клиента продолжается немедленно после того, как сделан запрос. Когда данные приложения сервера - доступны, выполняется пользовательская функция, указанная в cUDFName . В определяемую пользователем функцию передаются шесть параметров в следующем порядке:

Параметр Содержание

Channel Number

Номер канала приложения - сервера.

Action

XACTCOMPLETE (успешный транзакция).XACTFAIL (неудавшаяся транзакция).

Item

Имя пункта; например, R1C1 для ячейки рабочего листа Microsoft Excel.

Data

Новые данные (REQUEST) или отправленные данные (POKE или EXECUTED).

Format

Формат данных; например, CF_TEXT.

Transaction Number

Номер транзакции возвращенный DDEPoke( ) .

Используйте DDEAbortTrans( ), чтобы отменить незаконченную транзакцию. Если транзакция не выполнена, используйте DDELastError( ), для определения причины сбоя. Когда Вы включаете cUDFName , DDEPoke( ) возвращает номер транзакции, если она успешно завершилась или -1, если произошла ошибка.

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

Логическое

Замечания

DDEPoke( ) отправляет данные в виде символьная строка на имя пункта в приложении, указанным номером канала.

Если данные успешно посылают, DDEPoke( ) возвращмет истину (.T).. Если данные послать невозможно, DDEPoke( ) возвращмет ложь (.F).. Если включена асинхронная определяемая пользователем функция cUDFName , DDEPoke( ) возвращает номер транзакции; если происходит ошибка, DDEPoke( ) возвращмет -1.

См. Также