XTYP_ADVREQ トランザクション

XTYP_ADVREQ トランザクションは、指定されたトピック名とアイテム名のペアでアドバイス トランザクションが未処理であり、トピック名とアイテム名のペアに対応するデータが変更されたことをサーバーに通知します。 サーバーが DdePostAdvise 関数を呼び出した後、システムは動的データ交換 (DDE) コールバック関数 DdeCallback にこのトランザクションを送信します。

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_ADVREQ             (0x0020 | XCLASS_DATA | XTYPF_NOBLOCK )

パラメーター

uType

トランザクションの種類。

uFmt

データをクライアントに送信する形式。

hconv

会話へのハンドル。

hsz1

トピック名のハンドル。

hsz2

変更されたアイテム名へのハンドル。

hdata

使用されていません。

dwData1

DdePostAdvise 関数の現在の呼び出しのコンテキスト内で設定された、同じトピック、アイテム、および形式名で処理されるトランザクションXTYP_ADVREQの、下位ワードの数。 現在の XTYP_ADVREQ トランザクションが最後のトランザクションの場合、カウントは 0 です。 サーバーはこのカウントを使用して、アドバイス データに HDATA_APPOWNED データ ハンドルを作成するかどうかを判断できます。

クライアントからの遅延到着 DDE_ACK メッセージがサーバーによって実行されたために DDEML が XTYP_ADVREQ トランザクションを発行した場合、下位ワードは CADV_LATEACK に設定されます。

高次ワードは使用されません。

dwData2

使用されていません。

戻り値

サーバーはまず DdeCreateDataHandle 関数を呼び出して、変更されたデータを識別し、ハンドルを返すデータ ハンドルを作成する必要があります。 トランザクションを完了できない場合、サーバーは NULL を 返す必要があります。

注釈

サーバーはこのトランザクションの種類をブロックできません。 CBR_BLOCK 戻りコードは無視されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Ddeml.h (Windows.h を含む)

関連項目

参照

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

概念

動的データ交換管理ライブラリ