На главную

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

DdeConnectList



The DdeConnectList function establishes a conversation with all server applications that support the specified service name and topic name pair. An application can also use this function to obtain a list of conversation handles by passing the function an existing conversation handle. The Dynamic Data Exchange Management Library removes the handles of any terminated conversations from the conversation list. The resulting conversation list contains the handles of all currently established conversations that support the specified service name and topic name.

HCONVLIST DdeConnectList(

DWORD idInst, // instance identifier
HSZ hszService, // handle to service name string
HSZ hszTopic, // handle to topic name string
HCONVLIST hConvList, // handle to conversation list
PCONVCONTEXT pCC // pointer to structure with context data
);


Parameters

idInst

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

hszService

Identifies the string that specifies the service name of the server application with which a conversation is to be established. If this parameter is 0L, the system attempts to establish conversations with all available servers that support the specified topic name.

hszTopic

Identifies the string that specifies the name of the topic on which a conversation is to be established. This handle must have been created by a previous call to the DdeCreateStringHandle function. If this parameter is 0L, the system will attempt to establish conversations on all topics supported by the selected server (or servers).

hConvList

Identifies the conversation list to be enumerated. This parameter should be 0L if a new conversation list is to be established.

pCC

Points to the CONVCONTEXT structure that contains conversation-context information. If this parameter is NULL, the server receives the default CONVCONTEXT structure during the XTYP_CONNECT or XTYP_WILDCONNECT transaction.



Return Values

If the function succeeds, the return value is the handle to a new conversation list.
If the function fails, the return value is 0L. The handle to the old conversation list is no longer valid.

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_INVALID_PARAMETER
DMLERR_NO_CONV_ESTABLISHED
DMLERR_NO_ERROR
DMLERR_SYS_ERROR

Remarks

An application must free the conversation list handle returned by the DdeConnectList function, regardless of whether any conversation handles within the list are active. To free the handle, an application can call DdeDisconnectList.
All members of the default CONVCONTEXT structure are set to zero except cb, specifying the size of the structure, and iCodePage, specifying CP_WINANSI (the default code page) or CP_WINUNICODE, depending on whether the ANSI or Unicode version of the DdeInitialize function was called by the client application.

See Also

CONVCONTEXT, DdeConnect, DdeCreateStringHandle, DdeDisconnect, DdeDisconnectList, DdeInitialize, DdeQueryNextServer


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

DdeConnectList



Функция DdeConnectList устанавливает разговор со всеми приложениями сервера, которые поддерживают определенное имя услуги и пары имени темы. Приложение может также использовать эту функцию, чтобы получать список ручек разговора передавая функцию существующая ручка разговора. Биржевое Управление Динамической Библиотеки Данных удаляет ручки любой расторгнутой беседы из списка разговора. Результирующий список разговора содержит ручки всей к настоящему времени установленной беседы, которая поддерживает определенное имя имени услуги и темы.

HCONVLIST DdeConnectList(

DWORD idInst, // ИДЕНТИФИКАТОР примера HSZ hszService, // ручка, чтобы обслуживать строку имени HSZ hszTopic, // ручка в строку имени темы HCONVLIST hConvList, // ручка в список разговора PCONVCONTEXT pCC // указатель в структуру с контекстными данными
);


Параметры

idInst

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

hszService

Идентифицирует строку, которая определяет имя услуги приложения сервера с которым разговор должен быть установлен. Если этот параметр является 0L, системными попытками, чтобы устанавливать беседу со всеми доступными серверами, которые поддерживают определенное имя темы.

hszTopic

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

hConvList

Идентифицирует список разговора, чтобы быть перечисленн. Этот параметр должен быть 0L если новый список разговора должен быть установлен.

pCC

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



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

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

Ошибки

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

Замечания

Приложение должно освободить ручку списка разговора возвращанную функцией DdeConnectList, независимо от того, что любой разговор оперируется в пределах списка активны. Чтобы освобождать ручку, приложение может назвать DdeDisconnectList.
Все участники по умолчанию структуры CONVCONTEXT установлены в нуль кроме cb, определяя размер структуры, и iCodePage, определяющий CP_WINANSI ( по умолчанию кодовая страница) или CP_WINUNICODE, или ANSI или версия Уникода функции DdeInitialize была названа приложением клиента.

Смотри Также

CONVCONTEXT, DdeConnect, DdeCreateStringHandle, DdeDisconnect, DdeDisconnectList, DdeInitialize, DdeQueryNextServer


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