DdeFreeDataHandle 函式 (ddeml.h)

釋放動態 Data Exchange (DDE) 物件，並刪除與對象相關聯的數據處理句柄。

語法

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

[in] hData

類型： HDDEDATA

要釋放之 DDE 物件的句柄。此句柄必須由先前呼叫 DdeCreateDataHandle 函式所建立，或由 DdeClientTransaction 函式傳回。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

DdeGetLastError 函式可用來取得錯誤碼，這可以是下列其中一個值：

應用程式必須在下列情況下呼叫 DdeFreeDataHandle ：

如果應用程式從未將對象的數據處理句柄傳遞至另一個動態 Data Exchange Management Library (DDEML) 函式，則呼叫 DdeCreateDataHandle 函式來釋放應用程式所配置的 DDE 物件
在呼叫 DdeCreateDataHandle 中指定HDATA_APPOWNED旗標，釋放應用程式配置的 DDE 物件
釋放 DDE 物件，其處理從 DdeClientTransaction 函式接收的應用程式

當 DDE 回呼函式傳回其句柄或當做 DDEML 函式中的參數使用時，系統會自動釋放未擁有的物件。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	ddeml.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll