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 | Скачать

Retrieving an Item from the Server

To retrieve an item from the server, the client sends the server a WM_DDE_REQUEST message specifying the item and format to retrieve, as shown in the following example.

if ((atomItem = GlobalAddAtom(szItemName)) != 0) {
if (!PostMessage(hwndServerDDE,
WM_DDE_REQUEST,
(WPARAM) hwndClientDDE,
PackDDElParam(WM_DDE_REQUEST, CF_TEXT, atomItem)))
GlobalDeleteAtom(atomItem);
}

if (atomItem == 0) {

.
. /* error handling */
.

}

In this example, the client specifies the clipboard format CF_TEXT as the preferred format for the requested data item.
The receiver (server) of the WM_DDE_REQUEST message typically must delete the item atom, but if the PostMessage call fails, the client must delete the atom.
If the server has access to the requested item and can render it in the requested format, the server copies the item value as a shared memory object and sends the client a WM_DDE_DATA message, as illustrated in the following example.

/*
* Allocate the size of the DDE data header, plus the data: a
* string,. The byte for the string's terminating
* null character is counted by DDEDATA.Value[1].
*/

if (!(hData = GlobalAlloc(GMEM_MOVEABLE | GMEM_DDESHARE,
(LONG) sizeof(DDEDATA) + lstrlen(szItemValue) + 2)))
return;

if (!(lpData = (DDEDATA FAR*) GlobalLock(hData))) {
GlobalFree(hData);
return;

}
.
.
.

lpData->cfFormat = CF_TEXT;

lstrcpy((LPSTR) lpData->Value, (LPSTR) szItemValue);

/* Each line of CF_TEXT data is terminated by CR/LF. */

lstrcat((LPSTR) lpData->Value, (LPSTR) "\r\n");
GlobalUnlock(hData);
if ((atomItem = GlobalAddAtom((LPSTR) szItemName)) != 0) {
lParam = PackDDElParam(WM_DDE_ACK, (UINT) hData, atomItem);
if (!PostMessage(hwndClientDDE,
WM_DDE_DATA,
(WPARAM) hwndServerDDE,
lParam)) {
GlobalFree(hData);
GlobalDeleteAtom(atomItem);

FreeDDElParam(WM_DDE_ACK, lParam);
}
}

if (atomItem == 0) {

.
. /* error handling */
.

}

In this example, the server application allocates a memory object to contain the data item. The memory is allocated with the GMEM_DDESHARE option, so that the server and client applications can share the memory. After allocating the memory object, the server application locks the object so it can obtain the object's address. The data object is initialized as a DDEDATA structure.
The server application then sets the cfFormat member of the structure to CF_TEXT to inform the client application that the data is in text format. The client responds by copying the value of the requested data into the Value member of the DDEDATA structure. After the server has filled the data object, the server unlocks the data and creates a global atom containing the name of the data item.

Finally, the server issues the WM_DDE_DATA message by calling PostMessage. The handle of the data object and the atom containing the item name are packed into the lParam parameter of the message by the PackDDElParam function.
If PostMessage fails, the server must use the FreeDDElParam function to free the packed lParam parameter. The server must also free the packed lParam parameter for the WM_DDE_REQUEST message it received.

If the server cannot satisfy the request, it sends a negative WM_DDE_ACK message to the client, as shown in the following example.

/* negative acknowledgment */

PostMessage(hwndClientDDE,
WM_DDE_ACK,
(WPARAM) hwndServerDDE,
PackDDElParam(WM_DDE_ACK, 0, atomItem));

Upon receiving a WM_DDE_DATA message, the client processes the data-item value as appropriate. Then, if the fAckReq member pointed to in the WM_DDE_DATA message is 1, the client must send the server a positive WM_DDE_ACK message, as shown in the following example.

UnpackDDElParam(WM_DDE_DATA, lParam, (PUINT) &hData,
(PUINT) &atomItem);
if (!(lpDDEData = (DDEDATA FAR*) GlobalLock(hData))
|| (lpDDEData->cfFormat != CF_TEXT)) {
PostMessage(hwndServerDDE,
WM_DDE_ACK,
(WPARAM) hwndClientDDE,
PackDDElParam(WM_DDE_ACK, 0, atomItem)); /* negative ACK */
}

/* Copy data from lpDDEData here.*/

if (lpDDEData->fAckReq) {
PostMessage(hwndServerDDE,
WM_DDE_ACK,
(WPARAM) hwndClientDDE,

PackDDElParam(WM_DDE_ACK, 0x8000,
atomItem)); /* positive ACK */
}

bRelease = lpDDEData->fRelease;
GlobalUnlock(hData);
if (bRelease)
GlobalFree(hData);

In this example, the client examines the format of the data. If the format is not CF_TEXT (or if the client cannot lock the memory for the data), the client sends a negative WM_DDE_ACK message to indicate that it cannot process the data. If the client cannot lock a data handle because the handle contains the fAckReq member, the client should not send a negative WM_DDE_ACK message. Instead, the client should terminate the conversation.
If a client sends a negative acknowledgement in response to a WM_DDE_DATA message, the server is responsible for freeing the memory (but not the lParam parameter) referenced by the WM_DDE_DATA message associated with the negative acknowledgement.

If it can process the data, the client examines the fAckReq member of the DDEDATA structure to determine whether the server requested that it be informed that the client received and processed the data successfully. If the server did request this information, the client sends the server a positive WM_DDE_ACK message.
Because unlocking data invalidates the pointer to the data, the client saves the value of the fRelease member before unlocking the data object. After saving the value, the client then examines it to determine whether the server application requested the client to free the memory containing the data; the client acts accordingly.

Upon receiving a negative WM_DDE_ACK message, the client can ask for the same item value again, specifying a different clipboard format. Typically, a client will first ask for the most complex format it can support, then step down if necessary through progressively simpler formats until it finds one the server can provide.
If the server supports the Formats item of the system topic, the client can determine once what clipboard formats the server supports, instead of determining them each time the client requests an item. For more information about the system topic, see The System Topic.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Поиск Пункта из Сервера

Для того, чтобы извлекать пункт из сервера, клиент посылает серверу сообщение WM_DDE_REQUEST, определяющее пункт и формат, чтобы извлекаться, как показано в следующем примере.

если ((atomItem = GlobalAddAtom(szItemName)) != 0) { если (!PostMessage(hwndServerDDE, WM_DDE_REQUEST, (WPARAM) hwndClientDDE, PackDDElParam(WM_DDE_REQUEST, CF_TEXT, atomItem))) GlobalDeleteAtom(atomItem);
}

если (atomItem == 0) {

.
. /* обработка ошибки */
.

}

В этом примере, клиент определяет буфер формата CF_TEXT как предпочтительный формат для запрошенного пункта данных.
Получатель (сервер) сообщения WM_DDE_REQUEST обычно должен удалить атом пункта, но если вызов PostMessage терпит неудачу, клиент должен удалить атом.
Если сервер имеет доступ к запрошенному пункту и может предоставлять это в запрошенном формате, сервер копирует величину пункта как коллективную память возражать и посылает клиенту сообщение WM_DDE_DATA, как проиллюстрировано в следующем примере.

/*
* Распределите размер заголовка данных DDE, плюс данные: a
* строка,. Байт для завершения строки
* недействительный символ посчитался DDEDATA.Value[1].
*/

если (!Возврат (hData = GlobalAlloc(GMEM_MOVEABLE | GMEM_DDESHARE, (ДОЛГО (ДЛИНОЙ)) sizeof(DDEDATA) + lstrlen(szItemValue) + 2)));

если (!(lpData = (DDEDATA ЗНАЧИТЕЛЬНО*) GlobalLock(hData))) { GlobalFree(hData);
возврат;

}
.
.
.

lpData->cfFormat = CF_TEXT;

lstrcpy((LPSTR) lpData->Value, (LPSTR) szItemValue);

/* Каждая строка данных CF_TEXT расторгнутая CR/LF. */

lstrcat((LPSTR) lpData->Value, (LPSTR) "\r\n");
GlobalUnlock(hData);
если ((atomItem = GlobalAddAtom((LPSTR) szItemName)) != 0) { lParam = PackDDElParam(WM_DDE_ACK, (UINT) hData, atomItem);
если (!PostMessage(hwndClientDDE, WM_DDE_DATA, (WPARAM) hwndServerDDE, lParam)) { GlobalFree(hData);
GlobalDeleteAtom(atomItem);

FreeDDElParam(WM_DDE_ACK, lParam);
}
}

если (atomItem == 0) {

.
. /* обработка ошибки */
.

}

В этом примере, приложение сервера распределяет объект памяти против содержать пункт данных. Память распределена опцией GMEM_DDESHARE, чтобы сервер и приложения клиента могут распространить память. После распределения объекта памяти, приложение сервера запирает объект, так что оно может получить объектный адрес. Объект данных инициализирован как структура DDEDATA.
Приложение сервера затем устанавливает элемент cfFormat структуры на CF_TEXT, чтобы сообщать приложение клиента, что данные - в текстовом формате. Клиент отвечает копируя величину запрошенных данных в элемент Величины структуры DDEDATA. После того, как сервер заполнил объект данных, сервер деблокирует данные и создает глобальный атом содержа имя пункта данных.

Наконец, сервер выпускает сообщение WM_DDE_DATA вызывая PostMessage. Ручка объекта данных и атом, содержащий имя пункта упакована в параметр lParam сообщения функцией PackDDElParam.
Если PostMessage терпит неудачу, сервер должен использовать функцию FreeDDElParam, чтобы освобождать упакованный параметр lParam. Сервер должен также освободить упакованный параметр lParam для сообщения WM_DDE_REQUEST, которое он получен.

Если сервер не может удовлетворить запрос, это посылает негативу сообщение WM_DDE_ACK клиенту, как показано в следующем примере.

/* отрицательное признание */

PostMessage(hwndClientDDE, WM_DDE_ACK, (WPARAM) hwndServerDDE, PackDDElParam(WM_DDE_ACK, 0, atomItem));

На получающем сообщение WM_DDE_DATA, клиент обрабатывает данные-пункт величины как подходящий. Затем, если элемент fAckReq указанный, чтобы в сообщении WM_DDE_DATA - 1, клиент должен послать серверу положительное сообщение WM_DDE_ACK, как показано в следующем примере.

UnpackDDElParam(WM_DDE_DATA, lParam, (PUINT) &hData, (PUINT) &atomItem);
если (!(lpDDEData = (DDEDATA ЗНАЧИТЕЛЬНО*) GlobalLock(hData)) || (lpDDEData->cfFormat != CF_TEXT)) { PostMessage(hwndServerDDE, WM_DDE_ACK, (WPARAM) hwndClientDDE, PackDDElParam(WM_DDE_ACK, 0, atomItem)); /* негатив ACK */
}

/* Скопируйте данные из here. lpDDEData*/

если (lpDDEData->fAckReq) { PostMessage(hwndServerDDE, WM_DDE_ACK, (WPARAM) hwndClientDDE,

PackDDElParam(WM_DDE_ACK, 0x8000, atomItem)); /* положительный ACK */
}

bRelease = lpDDEData->fRelease;
GlobalUnlock(hData);
если (bRelease) GlobalFree(hData);

В этом примере, клиент изучает формат данных. Если формат - не CF_TEXT (или если клиент не может запереть память для данных), клиент посылает негативу сообщение WM_DDE_ACK, чтобы указывать, что он не может обработать данные. Если клиент не может запереть ручку данных поскольку ручка содержит элемент fAckReq, клиент не должен посылать негативу сообщение WM_DDE_ACK. Взамен, клиент должен завершить разговор.
Если клиент посылает отрицательное подтверждение в ответ на сообщение WM_DDE_DATA, сервер ответственный за освобождение памяти (но не параметр lParam) ссылавшееся сообщением WM_DDE_DATA связанным отрицательным подтверждением.

Если это может обработать данные, клиент изучает элемент fAckReq структуры DDEDATA, чтобы определять независимо сервер запрошенный, чтобы он был сообщен, что клиент получал и был обработан данные успешно. Если сервер запрашивал бы эту информацию, клиент посылает серверу положительное сообщение WM_DDE_ACK.
Поскольку разблокировка данных аннулирует указатель в данные, клиент сохраняет, величина fRelease элемент перед разблокировкой объекта данных. После экономии величины, клиент затем изучает это, чтобы определять независимо приложение сервера запросившее клиента, чтобы освобождать память, содержащую данные; клиент действует соответственно.

На получающем отрицательное сообщение WM_DDE_ACK, клиент может потребовать ту же величину пункта снова, определяющую другой формат буфера. Обычно, клиент будет сначала требовать сложный формат, который он может поддержать, затем сходить если необходимо через прогрессивно простые форматы до, это находит один сервер может обеспечиться.
Если сервер поддерживает пункт Форматов системной темы, клиент может определиться как только какой буфер отформатирует опоры сервера, вместо определения них всякий раз, когда клиент запрашивает пункт. Более подробно о системной теме, смотри Системную Тему.

Используются технологии uCoz