DdeSetUserHandle 関数 (ddeml.h)

アプリケーション定義値をメッセージ交換ハンドルまたはトランザクション識別子に関連付けます。これは、非同期トランザクションの処理を簡略化するのに役立ちます。アプリケーションでは、 DdeQueryConvInfo 関数を使用してこの値を取得できます。

構文

BOOL DdeSetUserHandle(
  [in] HCONV     hConv,
  [in] DWORD     id,
  [in] DWORD_PTR hUser
);

[in] hConv

種類: HCONV

会話のハンドル。

[in] id

型: DWORD

hUser パラメーターで指定された値に関連付けるトランザクション識別子。 hUser を hConv パラメーターによって識別される会話に関連付けるには、アプリケーションでこのパラメーターを QID_SYNC に設定する必要があります。

[in] hUser

種類: DWORD_PTR

会話ハンドルに関連付ける値。

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

DdeGetLastError 関数を使用してエラーコードを取得できます。次のいずれかの値を指定できます。

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