На главную

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

DdeEnableCallback



The DdeEnableCallback function enables or disables transactions for a specific conversation or for all conversations currently established by the calling application.

After disabling transactions for a conversation, the operating system places the transactions for that conversation in a transaction queue associated with the application. The application should reenable the conversation as soon as possible to avoid losing queued transactions.

BOOL DdeEnableCallback(

DWORD idInst, // instance identifier
HCONV hConv, // handle to conversation
UINT wCmd // enable or disable function code
);


Parameters

idInst

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

hConv

Identifies the conversation to enable or disable. If this parameter is NULL, the function affects all conversations.

wCmd

Specifies the function code. This parameter can be one of the following values:

Value Meaning
EC_ENABLEALL Enables all transactions for the specified conversation.
EC_ENABLEONE Enables one transaction for the specified conversation.
EC_DISABLE Disables all blockable transactions for the specified conversation.A server application can disable the following transactions:XTYP_ADVSTART
XTYP_ADVSTOP
XTYP_EXECUTE
XTYP_POKE
XTYP_REQUESTA client application can disable the following transactions:XTYP_ADVDATA
XTYP_XACT_COMPLETE
EC_QUERYWAITING Determines whether any transactions are in the queue for the specified conversation.


Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
If the wCmd parameter is EC_QUERYWAITING, and the application transaction queue contains one or more unprocessed transactions that are not being processed, the return value is TRUE; otherwise, it is FALSE.

Errors

Use the DdeGetLastError function to retrieve the error code, which may be one of the following:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_NO_ERROR
DMLERR_INVALIDPARAMETER

Remarks

An application can disable transactions for a specific conversation by returning the CBR_BLOCK return code from its dynamic data exchange (DDE) callback function. When you reenable the conversation by using the DdeEnableCallback function, the operating system generates the same transaction that was in process when the conversation was disabled.
Using the EC_QUERYWAITING flag does not change the enable state of the conversation and does not cause transactions to be issued within the context of the call to DdeEnableCallback.

If DdeEnableCallback is called with EC_QUERYWAITING and the return value is TRUE, an application should try to quickly allow message processing, return from its callback, or enable callbacks. Such a result does not guarantee that subsequent callbacks will be made. Calling DdeEnableCallback with EC_QUERYWAITING lets an application with blocked callbacks determine whether there are any transactions pending on the blocked conversation. Of course, even if such a call returns false, an application should always process messages in a timely manner.

See Also

DdeConnect, DdeConnectList, DdeDisconnect, DdeInitialize


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

DdeEnableCallback



Функция DdeEnableCallback приспосабливается или выводит из строя сделки для специфического разговора или для всей беседы к настоящему времени установленной вызывающим приложением.

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

BOOL DdeEnableCallback(

DWORD idInst, // ИДЕНТИФИКАТОР примера HCONV hConv, // ручка в разговор UINT wCmd // приспосабливается или выводит из строя функциональный код
);


Параметры

idInst

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

hConv

Идентифицирует разговор, чтобы приспосабливаться или выводиться из строя. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция влияет на всю беседу.

wCmd

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

Значение Величины
EC_ENABLEALL Приспосабливается все сделки для определенного разговора.
EC_ENABLEONE Приспосабливается одну сделку для определенного разговора.
EC_DISABLE Выводит из строя все blockable сделки для определенного разговора.Приложение сервера может вывести из строя следующие сделки:приложение клиента XTYP_ADVSTART XTYP_ADVSTOP XTYP_EXECUTE XTYP_POKE XTYP_REQUESTA может вывести из строя следующие сделки:XTYP_ADVDATA XTYP_XACT_COMPLETE EC_QUERYWAITING Определяет что независимо любые сделки - в очереди для определенного разговора.


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

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая.
Если параметр wCmd - EC_QUERYWAITING, и прикладная очередь сделки содержит одна или более unprocessed сделок, что не обрабатываться, обратная величина является ИСТИНОЙ; в противном случае, это ЛОЖНОЕ.

Ошибки

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

Замечания

Приложение может вывести из строя сделки для специфического разговора возвращав обратный код CBR_BLOCK из своего динамического обмена данных возврата (DDE) функция. Когда Вы восстанавливаете разговор используя функцию DdeEnableCallback, операционная система генерирует ту же сделку, которая была в процессе когда разговор был выведен из строя.
Использование флага EC_QUERYWAITING не изменяет допустимое состояние разговора и не вызывает сделки, которые нужно выпускаться в пределах контекста вызова на DdeEnableCallback.

Если DdeEnableCallback вызван EC_QUERYWAITING и обратная величина является ИСТИНОЙ, приложение должно пытаться быстро допускать обработку сообщения, возвращаться из своего возврата или приспосабливаться возвраты. Такой результат не гарантирует, что последующие возвраты будут сделаны. Разговор DdeEnableCallback с EC_QUERYWAITING позволяет приложение с блокированными возвратами определять есть ли любые сделки, рассматривающиеся в блокированном разговоре. Конечно, даже если бы такой вызов возвращает ложь, приложение должно всегда обрабатывать сообщения в своевременном способе.

Смотри Также

DdeConnect, DdeConnectList, DdeDisconnect, DdeInitialize


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