На главную

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

DdeCreateDataHandle



The DdeCreateDataHandle function creates a dynamic data exchange (DDE) object and fills the object with data from the specified buffer. A DDE application uses this function during transactions that involve passing data to the partner application.

HDDEDATA DdeCreateDataHandle(

DWORD idInst, // instance identifier
LPBYTE pSrc, // pointer to source buffer
DWORD cb, // length of DDE object
DWORD cbOff, // offset from beginning of source buffer
HSZ hszItem, // handle to item name string
UINT wFmt, // clipboard data format
UINT afCmd // creation flags
);


Parameters

idInst

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

pSrc

Points to a buffer that contains data to be copied to the DDE object. If this parameter is NULL, no data is copied to the object.

cb

Specifies the amount of memory, in bytes, to copy from the buffer pointed to by pSrc. If this parameter is zero, the pSrc parameter is ignored.

cbOff

Specifies an offset, in bytes, from the beginning of the buffer pointed to by the pSrc parameter. The data beginning at this offset is copied from the buffer to the DDE object.

hszItem

Identifies the string that specifies the data item corresponding to the DDE object. This handle must have been created by a previous call to the DdeCreateStringHandle function. If the data handle is to be used in an XTYP_EXECUTE transaction, this parameter must be 0L.

wFmt

Specifies the standard clipboard format of the data.

afCmd

Specifies the creation flags. This parameter can be HDATA_APPOWNED, which specifies that the server application calling the DdeCreateDataHandle function owns the data handle this function creates. This flag enables the application to share the data handle with other Dynamic Data Exchange Management Library (DDEML) applications rather than creating a separate handle to pass to each application. If this flag is specified, the application must eventually free the shared memory object associated with the handle by using the DdeFreeDataHandle function. If this flag is not specified, the handle becomes invalid in the application that created the handle after the data handle is returned by the application's DDE callback function or is used as a parameter in another DDEML function.



Return Values

If the function succeeds, the return value is a data handle.
If the function fails, the return value is 0L.

Errors

The DdeGetLastError function can be used to get the error code, which may be one of the following values:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_MEMORY_ERROR
DMLERR_NO_ERROR

Remarks

Any unfilled locations in the DDE object are undefined.
After a data handle has been used as a parameter in another DDEML function or has been returned by a DDE callback function, the handle may be used only for read access to the DDE object identified by the handle.

See Also

DdeAccessData, DdeCreateStringHandle, DdeFreeDataHandle, DdeGetData, DdeInitialize


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

DdeCreateDataHandle



Функция DdeCreateDataHandle создает динамический обмен данных (DDE) возражать и заполняет объект данными из определенного буфера. Приложение DDE использует эту функцию в течение сделок, которые включают прохождение данных в приложение партнера.

HDDEDATA DdeCreateDataHandle(

DWORD idInst, // ИДЕНТИФИКАТОР примера LPBYTE pSrc, // указатель в исходный буфер DWORD cb, // длина объекта DDE DWORD cbOff, // смещение из начала исходного буфера HSZ hszItem, // ручка в строку имени пункта UINT wFmt, // буфер формата данных UINT afCmd // создание сигнализирует
);


Параметры

idInst

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

pSrc

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

cb

Определяет сумму памяти, в байтах, чтобы копироваться из буфера указанного, чтобы pSrc. Если этот параметр является нулем, параметр pSrc проигнорирован.

cbOff

Определяет смещение, в байтах, из начала буфера указанного, чтобы параметром pSrc. Данные, начинающиеся в этом смещении скопированы от буфера до объекта DDE.

hszItem

Идентифицирует строку, которая определяет пункт данных, соответствуемый на объект DDE. Эта ручка по-видимому создана предшествующим вызовом в функцию DdeCreateStringHandle. Если ручка данных должна быть использована в сделке XTYP_EXECUTE, этот параметр должен быть 0L.

wFmt

Определяет стандартный формат буфера данных.

afCmd

Определяет флаги создания. Этот параметр может быть HDATA_APPOWNED, который определяет, что приложение сервера, вызывающее DdeCreateDataHandle функциональным собственным данные оперируют эту функцию создается. Этот флаг позволяет приложение, чтобы распространять ручке данных с другим Биржевым Управлением Динамической Библиотеки Данных (DDEML) приложений а не создание отдельной ручки, чтобы проходить в каждое приложение. Если этот флаг определен, приложение должно в конечном счете освободить коллективный объект памяти связанный ручкой используя функцию DdeFreeDataHandle. Если этот флаг не определен, ручка становится инвалидом в приложении, которое создавало ручку после того, как ручка данных будет возвращана прикладной функцией возврата DDE или будет использована как параметр в другой функции DDEML.



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

Если функция добивается успеха, обратная величина является ручкой данных.
Если функция терпит неудачу, обратная величина является 0L.

Ошибки

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

Замечания

Любые вакантные позиции на объекте DDE неопределенные.
После того, как ручка данных будет использована как параметр в другой функции DDEML или будет возвращан функцией возврата DDE, ручка может использоваться только для доступа чтения к объекту DDE идентифицированного ручкой.

Смотри Также

DdeAccessData, DdeCreateStringHandle, DdeFreeDataHandle, DdeGetData, DdeInitialize


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