DdePostAdvise 関数 (ddeml.h)
指定したトピックとアイテムに対して アクティブなア ドバイズ ループを使用して、各クライアントの呼び出し元 (サーバー) アプリケーションの Dynamic Data Exchange (DDE) コールバック関数に、システムがXTYP_ADVREQ トランザクションを送信します。 サーバー アプリケーションは、トピック名または項目名のペアに関連付けられているデータが変更されるたびに、この関数を呼び出す必要があります。
構文
BOOL DdePostAdvise(
[in] DWORD idInst,
[in] HSZ hszTopic,
[in] HSZ hszItem
);
パラメーター
[in] idInst
型: DWORD
DdeInitialize 関数の前回の呼び出しによって取得されたアプリケーション インスタンス識別子。
[in] hszTopic
種類: HSZ
トピック名を指定する文字列のハンドル。 アクティブなアドバイズ ループを含むすべてのトピックに対して通知を送信するには、アプリケーションでこのパラメーターを 0L に設定します。
[in] hszItem
種類: HSZ
項目名を指定する文字列へのハンドル。 アクティブなアドバイズ ループを持つすべてのアイテムに対して通知を送信するには、アプリケーションでこのパラメーターを 0L に設定します。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
DdeGetLastError 関数を使用してエラー コードを取得できます。次のいずれかの値を指定できます。
注釈
トピックまたは項目が数に制限されないサーバーでは、 hszTopic パラメーターと hszItem パラメーターを NULL に設定して、システムがアクティブなすべてのアドバイズ ループのトランザクションを生成するようにする必要があります。 サーバーの DDE コールバック関数は、更新してはならないすべてのアドバイズ ループに対して NULL を 返します。
サーバーが、XTYP_ADVREQコールバックで現在処理されているセットを含むトピック、アイテム、および書式名セットを使用して DdePostAdvise を呼び出すと、スタック オーバーフローが発生する可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ddeml.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
関連項目
概念
リファレンス