Condividi tramite

Struttura CONVINFO (ddeml.h)

  • Articolo

Contiene informazioni su una conversazione DDE (Dynamic Data Exchange).

Sintassi

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Members

cb

Tipo: DWORD

Dimensioni della struttura, in byte.

hUser

Tipo: DWORD_PTR

Dati definiti dall'applicazione.

hConvPartner

Tipo: HCONV

Handle per l'applicazione partner nella conversazione DDE. Questo membro è zero se il partner non è registrato (usando la funzione DdeInitialize ) per eseguire chiamate di funzione DDEML. Un'applicazione non deve passare questo membro a alcuna funzione DDEML tranne DdeQueryConvInfo.

hszSvcPartner

Tipo: HSZ

Handle al nome del servizio dell'applicazione partner.

hszServiceReq

Tipo: HSZ

Handle al nome del servizio dell'applicazione server richiesto per la connessione.

hszTopic

Tipo: HSZ

Handle per il nome dell'argomento richiesto.

hszItem

Tipo: HSZ

Handle per il nome dell'elemento richiesto. Questo membro è specifico della transazione.

wFmt

Tipo: UINT

Formato dei dati da scambiare. Questo membro è specifico della transazione.

wType

Tipo: UINT

Tipo della transazione corrente. Questo membro è specifico della transazione; può essere uno dei valori seguenti.

Valore Significato
XTYP_ADVDATA
0x4010
 Informa un client che informa che i dati di un server sono arrivati.
XTYP_ADVREQ
0x2022
 Richiede a un server di inviare dati aggiornati al client durante un ciclo di consigli. Questa transazione genera quando il server chiama DdePostAdvise.
XTYP_ADVSTART
0x1030
 Richiede a un server di avviare un ciclo di consigli con un client.
XTYP_ADVSTOP
0x8040
 Notifica a un server che un ciclo di consigli viene arrestato.
XTYP_CONNECT
0x1062
 Richiede a un server di stabilire una conversazione con un client.
XTYP_CONNECT_CONFIRM
0x8072
 Notifica a un server che è stata stabilita una conversazione con un client.
XTYP_DISCONNECT
0x80C2
 Notifica a un server che una conversazione è stata terminata.
XTYP_EXECUTE
0x4050
 Richiede a un server di eseguire un comando inviato da un client.
XTYP_MONITOR
0x80F2
 Notifica a un'applicazione registrata come APPCMD_MONITOR che i dati DDE vengono trasmessi.
XTYP_POKE
0x4090
 Richiede a un server di accettare dati non richiesti da un client.
XTYP_REGISTER
0x80A2
 Notifica ad altre applicazioni DDEML che un server ha registrato un nome del servizio.
XTYP_REQUEST
0x20B0
 Richiede a un server di inviare dati a un client.
XTYP_UNREGISTER
0x80D2
 Notifica ad altre applicazioni DDEML che un server ha annullato la registrazione di un nome del servizio.
XTYP_WILDCONNECT
0x20E2
 Richiede a un server di stabilire più conversazioni con lo stesso client.
XTYP_XACT_COMPLETE
0x8080
 Notifica a un client che è stata completata una transazione di dati asincrona.

wStatus

Tipo: UINT

Stato della conversazione corrente. Questo membro può essere uno o più dei valori seguenti.

Valore Significato
ST_ADVISE
0x0002
 Uno o più collegamenti sono in corso.
ST_BLOCKED
0x0008
 La conversazione viene bloccata.
ST_BLOCKNEXT
0x0080
 La conversazione verrà bloccata dopo aver chiamato il callback successivo.
ST_CLIENT
0x0010
 L'handle con0x0010versation passato alla funzione DdeQueryConvInfo è un handle lato client. Se l'handle è zero, l'handle di conversazione passato alla funzione DdeQueryConvInfo è un handle lato server.
ST_CONNECTED
0x0001
 La conversazione è connessa.
ST_INLIST
0x0040
 La conversazione è un membro di un elenco di conversazioni.
ST_ISLOCAL
0x0004
 Entrambi i lati della conversazione usano il DDEML.
ST_ISSELF
0x0100
 Entrambi i lati della conversazione usano la stessa istanza del DDEML.
ST_TERMINATED
0x0020
 La conversazione è stata terminata dal partner.

wConvst

Tipo: UINT

Stato della conversazione. Questo membro può essere uno dei valori seguenti.

Valore Significato
XST_ADVACKRCVD
13
 La transazione di avviso è stata appena completata.
XST_ADVDATAACKRCVD
16
 La transazione dati di avviso è stata appena completata.
XST_ADVDATASENT
15
 Avvisare che i dati sono stati inviati e sono in attesa di un riconoscimento.
XST_ADVSENT
11
 Una transazione di avviso è in attesa di un riconoscimento.
XST_CONNECTED
2
 La conversazione non ha transazioni attive.
XST_DATARCVD
6
 I dati richiesti sono stati ricevuti.
XST_EXECACKRCVD
10
 Una transazione di esecuzione è stata appena completata.
XST_EXECSENT
9
 Una transazione di esecuzione è in attesa di un riconoscimento.
XST_INCOMPLETE
1
 Ultima transazione non riuscita.
XST_INIT1
3
 Stato intermedio di avvio 1.
XST_INIT2
4
 Stato intermedio di avvio 2.
XST_NULL
0
 Stato di preavvio.
XST_POKEACKRCVD
8
 Una transazione poke è stata appena completata.
XST_POKESENT
7
 Una transazione poke è in attesa di un riconoscimento.
XST_REQSENT
5
 Una transazione di richiesta è in attesa di un riconoscimento.
XST_UNADVACKRCVD
14
 Una transazione di notifica è stata appena completata.
XST_UNADVSENT
12
 Una transazione nonvise è in attesa di un riconoscimento.

wLastError

Tipo: UINT

Valore di errore associato all'ultima transazione.

hConvList

Tipo: HCONVLIST

Handle per l'elenco di conversazioni se l'handle per la conversazione corrente si trova in un elenco di conversazioni. Questo membro è NULL se la conversazione non si trova in un elenco di conversazioni.

ConvCtxt

Tipo: CONVCONTEXT

Contesto della conversazione.

hwnd

Tipo: HWND

Handle per la finestra dell'applicazione chiamante coinvolta nella conversazione.

hwndPartner

Tipo: HWND

Handle per la finestra dell'applicazione partner coinvolta nella conversazione corrente.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione ddeml.h (include Windows.h)

Vedi anche

CONVCONTEXT

Informazioni concettuali

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

Libreria di gestione di Dynamic Data Exchange

Riferimento