Funzione DdeQueryConvInfo (ddeml.h)

Articolo
02/26/2024

Recupera informazioni su una transazione DDE (Dynamic Data Exchange) e sulla conversazione in cui viene eseguita la transazione.

Sintassi

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Parametri

[in] hConv

Tipo: HCONV

Handle per la conversazione.

[in] idTransaction

Tipo: DWORD

Transazione. Per le transazioni asincrone, questo parametro deve essere un identificatore di transazione restituito dalla funzione DdeClientTransaction . Per le transazioni sincrone, questo parametro deve essere QID_SYNC.

[in, out] pConvInfo

Tipo: PCONVINFO

Puntatore alla struttura CONVINFO che riceve informazioni sulla transazione e sulla conversazione. Il membro cb della struttura CONVINFO deve specificare la lunghezza del buffer allocato per la struttura.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito corrisponde al numero di byte copiati nella struttura CONVINFO .

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

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

Commenti

Un'applicazione non deve liberare un handle stringa a cui fa riferimento la struttura CONVINFO . Se un'applicazione deve usare uno di questi handle di stringa, deve chiamare la funzione DdeKeepStringHandle per creare una copia dell'handle.

Se il parametro idTransaction è impostato su QID_SYNC, il membro hUser della struttura CONVINFO è associato alla conversazione e può essere utilizzato per contenere i dati associati alla conversazione. Se idTransaction è l'identificatore di una transazione asincrona, il membro hUser è associato solo alla transazione corrente ed è valido solo per la durata della transazione.

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