DdeQueryConvInfo 関数 (ddeml.h)

[アーティクル]
08/23/2023

動的データ交換 (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 メンバーは現在のトランザクションにのみ関連付けられ、トランザクションの期間中のみ有効です。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ddeml.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll