DdeEnableCallback 函式 (ddeml.h)
啟用或停用特定交談的交易,或呼叫應用程式目前建立的所有交談。
語法
BOOL DdeEnableCallback(
[in] DWORD idInst,
[in] HCONV hConv,
[in] UINT wCmd
);
參數
[in] idInst
類型: DWORD
先前呼叫 DdeInitialize 函式所取得的應用程式實例識別碼。
[in] hConv
類型: HCONV
要啟用或停用之交談的控制碼。 如果此參數為 Null,函式會影響所有交談。
[in] wCmd
類型: UINT
函式程式碼。 此參數可以是下列其中一個值。
值 | 意義 |
---|---|
|
啟用指定交談的所有交易。 |
|
啟用指定交談的一筆交易。 |
|
停用指定交談的所有可封鎖交易。
伺服器應用程式可以停用下列交易: 用戶端應用程式可以停用下列交易: |
|
判斷是否有任何交易位於指定交談的佇列中。 |
傳回值
類型: BOOL
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
如果 wCmd 參數 EC_QUERYWAITING,且應用程式交易佇列包含一或多個未處理的交易,則傳回值為 TRUE;否則為 FALSE。
DdeGetLastError函式可用來取得錯誤碼,它可以是下列其中一個值:
備註
應用程式可以從其動態資料交換 (DDE) 回呼函式傳回 CBR_BLOCK 傳回碼,以停用特定交談的交易。 當您使用 DdeEnableCallback 函式重新啟用交談時,作業系統會產生與交談停用時相同的交易。
使用 EC_QUERYWAITING 旗標並不會變更交談的啟用狀態,而且不會在 呼叫 DdeEnableCallback的內容中發出交易。
如果使用EC_QUERYWAITING呼叫DdeEnableCallback,且函式傳回非零,應用程式應該嘗試快速允許訊息處理、從其回呼傳回或啟用回呼。 這類結果不保證會進行後續回呼。 使用EC_QUERYWAITING呼叫DdeEnableCallback可讓具有封鎖回呼的應用程式判斷封鎖的交談上是否有任何擱置的交易。 當然,即使這類呼叫傳回零,應用程式應該一律及時處理訊息。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ddeml.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
另請參閱
概念
參考