DdeQueryConvInfo 函式 (ddeml.h)

擷取動態數據交換 (DDE) 交易的相關信息，以及交易發生的交談相關信息。

語法

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

[in] hConv

類型： HCONV

交談的句柄。

[in] idTransaction

類型： DWORD

異動。對於異步交易，此參數應該是 DdeClientTransaction 函式所傳回的交易標識符。對於同步交易，此參數應該QID_SYNC。

[in, out] pConvInfo

類型： PCONVINFO

CONVINFO 結構的指標，可接收交易和交談的相關信息。 CONVINFO 結構的 cb 成員必須指定為結構配置的緩衝區長度。

類型： UINT

如果函式成功，傳回值就是複製到 CONVINFO 結構的位元元組數目。

如果函式失敗，則傳回值為 FALSE。

DdeGetLastError 函式可用來取得錯誤碼，它可以是下列其中一個值：

應用程式不應該釋放 CONVINFO 結構所參考的字串句柄。如果應用程式必須使用其中一個字串句柄，它應該呼叫 DdeKeepStringHandle 函式來建立句柄的複本。

如果 idTransaction 參數設定為 QID_SYNC，CONVINFO 結構的 hUser 成員會與交談相關聯，而且可用來保存與交談相關聯的數據。如果 idTransaction 是異步交易的標識碼， 則 hUser 成員只會與目前交易相關聯，而且只在交易期間有效。