|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |