Функция DDERequest( )

Запрашивает данные из приложения-сервера в ходе сеанса связи динамического о мена данными (DDE).

Синтаксис

DDERequest(nChannelNumber, cItemName [, cDataFormat [, cUDFName]])

Параметры

nChannelNumber

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

cItemName

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

cDataFormat

Задает формат запрошенных данных. По умолчанию используется формат CF_TEXT. В том формате поля разделяются табуляторами, а записи возвратом каретки и переводом строки.

cUDFName

Допускает асинхронную передачу данных. Если имя cUDFName опущено, Visual FoxPro ждет поступления данных из сервера в течение периода в емени, заданного функцией DDESetOption( ). Если вы задали имя пользовательской функции в аргументе cUDFName, Visual FoxPro продолжит выполнение программы сразу после выдачи запроса.

Когда данные берутся из приложения-сервера, выполняется пользовательская фу кция cUDFName. Ей передаются шесть параметров в следующем порядке.

Параметр	Содержимое
Channel Number (номер канала)	Номер канала приложения-сервера
Action (действие)	XACTCOMPLETE (успешная транзакция) XACTFAIL (ошибка в транзакции)
Item (элемент)	Имя элемента, например R1C1 в качестве имени ячейки электронной таблицы Microsoft Excel
Data (данные)	Новые данные (REQUEST) или передаваемые данные (POKE или EXECUTED)
Format (формат)	Формат данных, например CF_TEXT
Transaction Number (номер транзакции)	Номер транзакции, возвращаемый функцией DDERequest( )

Используйте функцию DDEAbortTrans( ) для отмены незавершенной транзакции. Если транзакция завершается неудачно, с помощью функции DDELastError( ) можно опре елить причину ошибки.

Если задан аргумент cUDFName, функция DDERequest( ) возвращает неотрицательный номер транзакции в случае успешного выполнения или 1 в случае ошибки.

Результат

Символьный

Комментарии

Допустима только в Visual FoxPro и FoxPro для Windows.

Перед тем как запрашивать данные с помощью функции DDERequest( ), необходимо установить канал с приложением-сервером, используя функцию DDEInitiate( ).

Если запрос данных увенчался успехом, DDERequest( ) возвращает данные в виде символьной строки. Если запрос оказывается неудачным, DDERequest( ) возвращает пустую строку, а DDELastError( ) ненулевое значение. Если задана асинхронная функция cUDFName, определенная пользователем, DDERequest( ) возвращает номер транзакции в с учае успеха или 1 в случае ошибки.