次の方法で共有


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

動的データ交換管理ライブラリ (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 を含む)

関連項目

概念

DdeEnableCallback

DdeInitialize

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