Funzione DdeConnect (ddeml.h)

Articolo
02/26/2024

Stabilisce una conversazione con un'applicazione server che supporta il nome del servizio e la coppia di nomi dell'argomento specificati. Se esistono più server di questo tipo, il sistema ne seleziona solo uno.

Sintassi

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [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. Questo handle deve essere stato creato da una chiamata precedente alla funzione DdeCreateStringHandle . Se questo parametro è 0L, viene stabilita una conversazione con qualsiasi server disponibile.

[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 a DdeCreateStringHandle. Se questo parametro è 0L, viene stabilita una conversazione su qualsiasi argomento supportato dal server selezionato.

[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: HCONV

Se la funzione ha esito positivo, il valore restituito è l'handle per la conversazione stabilita.

Se la funzione ha esito negativo, il valore restituito è 0L.

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

Commenti

L'applicazione client non può fare ipotesi relative al server selezionato. Se nel parametro hszService viene specificato un nome specifico dell'istanza, viene stabilita una conversazione con solo l'istanza specificata. I nomi di servizio specifici dell'istanza vengono passati alla funzione di callback DDE (Dynamic Data Exchange) di un'applicazione durante le transazioni XTYP_REGISTER e XTYP_UNREGISTER .

Tutti i membri della struttura CONVCONTEXT predefinita sono impostati su zero tranne cb, che specifica le dimensioni della struttura e iCodePage, che specifica 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