共用方式為


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

另請參閱

概念

DdeAccessData

DdeClientTransaction

DdeCreateDataHandle

動態數據交換管理連結庫

參考