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

目前交易的類型。 此參數是由交易類別旗標和交易類型旗標的組合所組成。 下表描述每個交易類別，並提供每個類別中的交易類型清單。 For information about a specific transaction type, see the individual description of that type in Remarks.

[in] wFmt

類型： UINT

傳送或接收資料的格式。

[in] hConv

類型： HCONV

與目前交易相關聯的交談控制碼。

[in] hsz1

類型： HSZ

字串的控制碼。 此參數的意義取決於目前交易的類型。 For the meaning of this parameter, see the description of the transaction type in Remarks.

[in] hsz2

類型： HSZ

字串的控制碼。 此參數的意義取決於目前交易的類型。 For the meaning of this parameter, see the description of the transaction type in Remarks.

[in] hData

類型： HDDEDATA

DDE 資料的控制碼。 此參數的意義取決於目前交易的類型。 For the meaning of this parameter, see the description of the transaction type in Remarks.

[in] dwData1

類型： ULONG_PTR

異動特定資料。 For the meaning of this parameter, see the description of the transaction type in Remarks.

[in] dwData2

類型： ULONG_PTR

異動特定資料。 For the meaning of this parameter, see the description of the transaction type in Remarks.

傳回值

類型： HDDEDATA

傳回值取決於交易類別。 如需傳回值的詳細資訊，請參閱個別交易類型的描述。

備註

XCLASS_BOOL

當 DDE 回呼函式完成處理屬於這個類別的交易時，應該會傳回 TRUE 或 FALSE 。 XCLASS_BOOL交易類別包含下列類型：

• XTYP_ADVSTART
• XTYP_CONNECT

XCLASS_DATA

當 DDE 回呼函式完成處理屬於這個類別的交易時，應該會傳回 DDE 控制碼、 CBR_BLOCK 傳回碼或 Null 。 XCLASS_DATA交易類別包含下列類型：

• XTYP_ADVREQ
• XTYP_REQUEST
• XTYP_WILDCONNECT

XCLASS_FLAGS

當 DDE 回呼函式完成處理屬於這個類別的交易時，應該會傳回 DDE_FACK、 DDE_FBUSY或 DDE_FNOTPROCESSED 。 XCLASS_FLAGS交易類別包含下列類型：

• XTYP_ADVDATA
• XTYP_EXECUTE
• XTYP_POKE

XCLASS_NOTIFICATION

屬於這個類別的交易類型僅供通知之用。 會忽略回呼函式的傳回值。 XCLASS_NOTIFICATION交易類別包含下列類型：

• XTYP_ADVSTOP
• XTYP_CONNECT_CONFIRM
• XTYP_DISCONNECT
• XTYP_ERROR
• XTYP_MONITOR
• XTYP_REGISTER
• XTYP_XACT_COMPLETE
• XTYP_UNREGISTER

回呼函式會針對未涉及建立或終止交談的交易，以非同步方式呼叫。 不常接受傳入訊息的應用程式將會降低 DDE 效能，因為動態資料交換管理程式庫 (DDEML) 會使用訊息來起始交易。

應用程式必須在 呼叫 DdeInitialize 函式中指定函式的指標，以註冊回呼函式。

需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	ddeml.h (包含 Windows.h)

另請參閱

概念

DdeEnableCallback

DdeInitialize

動態資料交換管理程式庫