Funzione DdeConnectList (ddeml.h)

Articolo
08/23/2023

Stabilisce una conversazione con tutte le applicazioni server che supportano il nome del servizio e la coppia di nomi dell'argomento specificati. Un'applicazione può anche usare questa funzione per ottenere un elenco di handle di conversazione passando la funzione un handle di conversazione esistente. Dynamic Data Exchange Management Library rimuove gli handle di qualsiasi conversazione terminata dall'elenco di conversazioni. L'elenco di conversazioni risultante contiene gli handle di tutte le conversazioni attualmente stabilite che supportano il nome del servizio e il nome dell'argomento specificati.

Sintassi

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

Parametri

[in] idInst

Tipo: DWORD

Identificatore dell'istanza dell'applicazione ottenuto da una chiamata precedente alla funzione DdeInitialize .

[in] hszService

Tipo: HSZ

Handle per la stringa che specifica il nome del servizio dell'applicazione server con cui deve essere stabilita una conversazione. Se questo parametro è 0L, il sistema tenta di stabilire conversazioni con tutti i server disponibili che supportano il nome dell'argomento specificato.

[in] hszTopic

Tipo: HSZ

Handle per la stringa che specifica il nome dell'argomento in cui deve essere stabilita una conversazione. Questo handle deve essere stato creato da una chiamata precedente alla funzione DdeCreateStringHandle . Se questo parametro è 0L, il sistema tenterà di stabilire conversazioni su tutti gli argomenti supportati dal server selezionato (o server).

[in] hConvList

Tipo: HCONVLIST

Handle per l'elenco di conversazioni da enumerare. Questo parametro deve essere 0L se deve essere stabilito un nuovo elenco di conversazioni.

[in, optional] pCC

Tipo: PCONVCONTEXT

Puntatore alla struttura CONVCONTEXT che contiene informazioni sul contesto della conversazione. Se questo parametro è NULL, il server riceve la struttura CONVCONTEXT predefinita durante la transazione XTYP_CONNECT o XTYP_WILDCONNECT .

Valore restituito

Tipo: HCONVLIST

Se la funzione ha esito positivo, il valore restituito è l'handle di un nuovo elenco di conversazioni.

Se la funzione ha esito negativo, il valore restituito è 0L. L'handle per l'elenco di conversazioni precedente non è più valido.

La funzione DdeGetLastError può essere usata per ottenere il codice di errore, che può essere uno dei valori seguenti:

Commenti

Un'applicazione deve liberare l'handle dell'elenco di conversazioni restituito dalla funzione DdeConnectList , indipendentemente dal fatto che gli handle di conversazione all'interno dell'elenco siano attivi. Per liberare l'handle, un'applicazione può chiamare DdeDisconnectList.

Tutti i membri della struttura CONVCONTEXT predefinita sono impostati su zero tranne cb, specificando le dimensioni della struttura e iCodePage, specificando CP_WINANSI (tabella codici predefinita) o CP_WINUNICODE, a seconda che la versione ANSI o Unicode della funzione DdeInitialize sia stata chiamata dall'applicazione client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddeml.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll