PFNCALLBACK コールバック関数 (ddeml.h)

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

動的データ交換管理ライブラリ (DDEML) 関数で使用されるアプリケーション定義のコールバック関数。動的データ交換 (DDE) トランザクションを処理します。 PFNCALLBACK 型は、このコールバック関数へのポインターを定義します。 DdeCallback は、アプリケーション定義関数名のプレースホルダーです。

構文

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

パラメーター

[in] wType

型: UINT

現在のトランザクションの種類。このパラメーターは、トランザクションクラスフラグとトランザクション型フラグの組み合わせで構成されます。次の表では、各トランザクションクラスについて説明し、各クラスのトランザクションの種類の一覧を示します。特定のトランザクションの種類の詳細については、「解説」でその種類の個々の説明を参照してください。

[in] wFmt

型: UINT

データの送受信形式。

[in] hConv

種類: HCONV

現在のトランザクションに関連付けられている会話へのハンドル。

[in] hsz1

種類: HSZ

文字列へのハンドル。このパラメーターの意味は、現在のトランザクションの種類によって異なります。このパラメーターの意味については、「解説」のトランザクションの種類の説明を参照してください。

[in] hsz2

種類: HSZ

[in] hData

種類: HDDEDATA

DDE データへのハンドル。このパラメーターの意味は、現在のトランザクションの種類によって異なります。このパラメーターの意味については、「解説」のトランザクションの種類の説明を参照してください。

[in] dwData1

種類: ULONG_PTR

トランザクション固有のデータ。このパラメーターの意味については、「解説」のトランザクションの種類の説明を参照してください。

[in] dwData2

種類: ULONG_PTR

トランザクション固有のデータ。このパラメーターの意味については、「解説」のトランザクションの種類の説明を参照してください。

戻り値

種類: HDDEDATA

戻り値はトランザクションクラスによって異なります。戻り値の詳細については、個々のトランザクションの種類の説明を参照してください。

解説

XCLASS_BOOL

DDE コールバック関数は、このクラスに属するトランザクションの処理が完了したときに TRUE または FALSE を 返す必要があります。 XCLASS_BOOL トランザクションクラスは、次の種類で構成されます。

XCLASS_DATA

DDE コールバック関数は、このクラスに属するトランザクションの処理が完了したときに、DDE ハンドル、 CBR_BLOCK リターンコード、または NULL を 返す必要があります。 XCLASS_DATA トランザクションクラスは、次の種類で構成されます。

XCLASS_FLAGS

DDE コールバック関数は、このクラス に属するトランザクションの処理が完了したときに、 DDE_FACK、DDE_FBUSY、または DDE_FNOTPROCESSED を返す必要があります。 XCLASS_FLAGS トランザクションクラスは、次の種類で構成されます。

XCLASS_NOTIFICATION

このクラスに属するトランザクションの種類は、通知のみを目的としています。コールバック関数からの戻り値は無視されます。 XCLASS_NOTIFICATION トランザクションクラスは、次の種類で構成されます。

コールバック関数は、会話の作成または終了を伴わないトランザクションに対して非同期的に呼び出されます。受信メッセージを頻繁に受け入れないアプリケーションでは、動的データ交換管理ライブラリ (DDEML) がメッセージを使用してトランザクションを開始するため、DDE のパフォーマンスが低下します。

アプリケーションでは、 DdeInitialize 関数の呼び出しで関数へのポインターを指定して、コールバック関数を登録する必要があります。

要件


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