На главную

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

DdeQueryConvInfo



The DdeQueryConvInfo function obtains information about a dynamic data exchange (DDE) transaction and about the conversation in which the transaction takes place.

UINT DdeQueryConvInfo(

HCONV hConv, // handle to conversation
DWORD idTransaction, // transaction identifier
PCONVINFO pConvInfo // pointer to structure with conversation data
);


Parameters

hConv

Identifies the conversation.

idTransaction

Specifies the transaction. For asynchronous transactions, this parameter should be a transaction identifier returned by the DdeClientTransaction function. For synchronous transactions, this parameter should be QID_SYNC.

pConvInfo

Points to the CONVINFO structure that receives information about the transaction and conversation. The cb member of the CONVINFO structure must specify the length of the buffer allocated for the structure.



Return Values

If the function succeeds, the return value is the number of bytes copied into the CONVINFO structure.
If the function fails, the return value is FALSE.

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_NO_CONV_ESTABLISHED
DMLERR_NO_ERROR
DMLERR_UNFOUND_QUEUE_ID

Remarks

An application should not free a string handle referenced by the CONVINFO structure. If an application must use one of these string handles, it should call the DdeKeepStringHandle function to create a copy of the handle.
If the idTransaction parameter is set to QID_SYNC, the hUser member of the CONVINFO structure is associated with the conversation and can be used to hold data associated with the conversation. If idTransaction is the identifier of an asynchronous transaction, the hUser member is associated only with the current transaction and is valid only for the duration of the transaction.

See Also

CONVINFO, DdeClientTransaction, DdeConnect, DdeConnectList, DdeKeepStringHandle, DdeQueryNextServer


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

DdeQueryConvInfo



Функция DdeQueryConvInfo получает информацию о динамическом обмене данных сделки (DDE) и о разговоре в котором сделка происходит.

UINT DdeQueryConvInfo(

HCONV hConv, // РУЧКА в разговор DWORD idTransaction, // идентификатор сделки PCONVINFO pConvInfo // указатель в структуру с данными разговора
);


Параметры

hConv

Идентифицирует разговор.

idTransaction

Определяет сделку. Для асинхронных сделок, этот параметр должен быть идентификатором сделки возвращанным функцией DdeClientTransaction. Для синхронных сделок, этот параметр должен быть QID_SYNC.

pConvInfo

Точки на структуру CONVINFO, которые получают информации о сделке и разговоре. cb Элемент структуры CONVINFO должен определить длину буфера распределенного для структуры.



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

Если функция добивается успеха, обратная величина является количеством байтов скопированных в структуру CONVINFO.
Если функция терпит неудачу, обратная величина ЛОЖНАЯ.

Ошибки

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

Замечания

Приложение не должно освобождать ручку строки ссылавшуюся структурой CONVINFO. Если приложение должно использовать одну из этих ручек строки, оно должно называть функцию DdeKeepStringHandle, чтобы создавать копию ручки.
Если параметр idTransaction установлен на QID_SYNC, элемент hUser структуры CONVINFO связан разговором и может быть использовано, чтобы держать данные связанные разговором. Если idTransaction - идентификатор асинхронной сделки, элемент hUser связывается только с текущей сделкой и - в силе только в течение сделки.

Смотри Также

CONVINFO, DdeClientTransaction, DdeConnect, DdeConnectList, DdeKeepStringHandle, DdeQueryNextServer


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