На главную

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 | Скачать Вниз

WM_DDE_POKE



A DDE client application posts a WM_DDE_POKE message to a DDE server application. A client uses this message to request the server to accept an unsolicited data item. The server is expected to reply with a WM_DDE_ACK message indicating whether it accepted the data item.

WM_DDE_POKE
wParam = (WPARAM) hwnd; // handle of posting application
lParam = (LPARAM) lPackedVal; // packed DDEPOKE and item atom


Parameters

hwnd

Value of wParam. Identifies the client window posting the message.

lPackedVal

Value of lParam. The component parameters that are packed into lPackedVal are extracted by calling the UnpackDDElParam function. The low-order word is hData. The high-order word is aItem.

Parameter Description
hData Identifies a global memory object containing a DDEPOKE structure with the data and additional information.
aItem Contains a global atom that identifies the data item for which the data or notification is being sent.


Remarks

Posting

The client application posts the WM_DDE_POKE message by using the PostMessage function.
The client application must allocate memory for the hData object by using the GlobalAlloc function with the GMEM_DDESHARE option. The client application must delete the hData object if either of the following conditions is true:

· The server application responds with a negative WM_DDE_ACK message.
· The fRelease member is FALSE, but the server application responds with either a positive or negative WM_DDE_ACK.



The client application must create the aItem atom by using the GlobalAddAtom function.
The client application must create or reuse the WM_DDE_POKE lPackedVal parameter by calling the PackDDElParam function or the ReuseDDElParam function with hData supplied as the low-order word and aItem supplied as the high-order word.

Receiving

The server application should post the WM_DDE_ACK message to respond positively or negatively. When posting WM_DDE_ACK, the server can either reuse the aItem atom, or it can delete it and create a new one.
The server must create or reuse the WM_DDE_ACK lPackedVal parameter by calling the PackDDElParam function or the ReuseDDElParam function with wStatus supplied as the low-order word and aItem supplied as the high-order word.

To free the hData object, the server should call the GlobalFree function. Also, if the data format is either CF_DSPMETAFILEPICT or CF_METAFILEPICT, the server must also call DeleteMetaFile with the embedded metafile handle. These two formats have an extra level of indirection; that is, an application must lock hData to get a pointer to a handle, then lock that handle to get a pointer to a METAFILEPICT structure, and finally call DeleteMetaFile with the handle from the hMF member of the METAFILEPICT structure.

To free the lPackedVal object, the server should call the FreeDDElParam function.

See Also

DDEPOKE, DeleteMetaFile, FreeDDElParam, GlobalAddAtom, GlobalAlloc, GlobalFree, METAFILEPICT, PackDDElParam, PostMessage, ReuseDDElParam, SendMessage, UnpackDDElParam, WM_DDE_ACK


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

WM_DDE_POKE



Приложение клиента DDE посылает сообщение WM_DDE_POKE в приложение сервера DDE. Клиент использует это сообщение, чтобы запрашивать сервер, чтобы принимать непредусмотренный пункт данных. Сервер ожидается отвечает с сообщением WM_DDE_ACK, указывающим приняло это пункт данных.

WM_DDE_POKE
wParam = (WPARAM) hwnd; // ручка приложения почтового отправления lParam = (LPARAM) lPackedVal; // упакованный DDEPOKE и атом пункта


Параметры

hwnd

Величина wParam. Идентифицирует почтовому отправления окна клиента сообщение.

lPackedVal

Величина lParam. Компонентные параметры, которые упакованы в lPackedVal извлечены разговором функции UnpackDDElParam. Младшее слово - hData. Старшее слово - aItem.

Описание Параметра
hData Идентифицирует глобальный объект памяти, содержащий структуру DDEPOKE с данными и дополнительной информацией.
aItem Содержит глобальный атом, который идентифицирует пункт данных для которого данные или уведомление посылается.


Замечания

Почтовое отправления

Приложение клиента посылает сообщение WM_DDE_POKE используя функцию PostMessage.
Приложение клиента должно распределить память для hData возражать используя функцию GlobalAlloc с опцией GMEM_DDESHARE. Приложение клиента должно удалить объект hData если любое из следующих условий является истиной:

Приложение сервера указывает отрицательное сообщение WM_DDE_ACK.
fRelease Элемент является ЛОЖЬЮ, но приложение сервера указывает или положительный или отрицательный WM_DDE_ACK.



Приложение клиента должно создать атом aItem используя функцию GlobalAddAtom.
Приложение клиента должно создать или использовать многократно параметр WM_DDE_POKE lPackedVal вызывая функцию PackDDElParam или функция ReuseDDElParam с hData поставленное как младшее слово и aItem поставленный как старшее слово.

Получающий

Приложение сервера должно посылать сообщение WM_DDE_ACK, чтобы отвечать положительно или negatively. Когда почтовое отправления WM_DDE_ACK, сервер может или использовать многократно атом aItem, или это может удалить это и создает новый.
Сервер должен создать или использовать многократно параметр WM_DDE_ACK lPackedVal вызывая функцию PackDDElParam или функция ReuseDDElParam с wStatus поставленное как младшее слово и aItem поставленный как старшее слово.

Для того, чтобы освобождать объект hData, сервер должен вызывать функцию GlobalFree. Также, если формат данных - или CF_DSPMETAFILEPICT или CF_METAFILEPICT, сервер должен также вызвать DeleteMetaFile с вложенной ручкой метафайла. Эти два формата имеют дополнительный уровень косвенности; то есть, приложение должно запереть hData, чтобы получать указатель в ручку затем запирать, что оперироваться, чтобы получать указатель в структуру METAFILEPICT и наконец вызывать DeleteMetaFile с ручкой из элемента hMF структуры METAFILEPICT.

Для того, чтобы освобождать объект lPackedVal, сервер должен вызывать функцию FreeDDElParam.

Смотри Также

DDEPOKE, DeleteMetaFile, FreeDDElParam, GlobalAddAtom, GlobalAlloc, GlobalFree, METAFILEPICT, PackDDElParam, PostMessage, ReuseDDElParam, SendMessage, UnpackDDElParam, WM_DDE_ACK


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