Função DdeConnectList (ddeml.h)

Artigo
02/28/2024

Estabelece uma conversa com todos os aplicativos de servidor que dão suporte ao nome do serviço e ao par de nomes de tópico especificados. Um aplicativo também pode usar essa função para obter uma lista de identificadores de conversa passando a função um identificador de conversa existente. A Biblioteca de Gerenciamento dinâmico do Exchange de Dados remove os identificadores de todas as conversas encerradas da lista de conversas. A lista de conversas resultante contém os identificadores de todas as conversas estabelecidas no momento que dão suporte ao nome do serviço e ao nome do tópico especificados.

Sintaxe

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in] hszService

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o nome do serviço do aplicativo de servidor com o qual uma conversa deve ser estabelecida. Se esse parâmetro for 0L, o sistema tentará estabelecer conversas com todos os servidores disponíveis que dão suporte ao nome do tópico especificado.

[in] hszTopic

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o nome do tópico no qual uma conversa deve ser estabelecida. Esse identificador deve ter sido criado por uma chamada anterior para a função DdeCreateStringHandle . Se esse parâmetro for 0L, o sistema tentará estabelecer conversas sobre todos os tópicos compatíveis com o servidor selecionado (ou servidores).

[in] hConvList

Tipo: HCONVLIST

Um identificador para a lista de conversa a ser enumerada. Esse parâmetro deverá ser 0L se uma nova lista de conversas for estabelecida.

[in, optional] pCC

Tipo: PCONVCONTEXT

Um ponteiro para a estrutura CONVCONTEXT que contém informações de contexto de conversa. Se esse parâmetro for NULL, o servidor receberá a estrutura CONVCONTEXT padrão durante a transação XTYP_CONNECT ou XTYP_WILDCONNECT .

Retornar valor

Tipo: HCONVLIST

Se a função for bem-sucedida, o valor retornado será o identificador para uma nova lista de conversas.

Se a função falhar, o valor retornado será 0L. O identificador para a lista de conversa antiga não é mais válido.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Um aplicativo deve liberar o identificador de lista de conversa retornado pela função DdeConnectList , independentemente de qualquer identificador de conversa na lista estar ativo. Para liberar o identificador, um aplicativo pode chamar DdeDisconnectList.

Todos os membros da estrutura CONVCONTEXT padrão são definidos como zero, exceto cb, especificando o tamanho da estrutura e iCodePage, especificando CP_WINANSI (a página de código padrão) ou CP_WINUNICODE, dependendo se a versão ANSI ou Unicode da função DdeInitialize foi chamada pelo aplicativo cliente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll