DdeFreeDataHandle 함수(ddeml.h)

DDE(동적 데이터 교환) 개체를 해제하고 개체와 연결된 데이터 핸들을 삭제합니다.

구문

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

[in] hData

형식: HDDEDATA

해제할 DDE 개체에 대한 핸들입니다. 이 핸들은 DdeCreateDataHandle 함수에 대한 이전 호출에 의해 생성되었거나 DdeClientTransaction 함수에서 반환되어야 합니다.

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

DdeGetLastError 함수를 사용하여 다음 값 중 하나일 수 있는 오류 코드를 가져올 수 있습니다.

애플리케이션은 다음과 같은 상황에서 DdeFreeDataHandle 을 호출해야 합니다.

애플리케이션에서 DDEML(동적 데이터 교환 관리 라이브러리) 함수에 개체의 데이터 핸들을 전달하지 않은 경우 DdeCreateDataHandle 함수를 호출하여 애플리케이션이 할당한 DDE 개체를 해제하려면
DdeCreateDataHandle 호출에서 HDATA_APPOWNED 플래그를 지정하여 애플리케이션이 할당한 DDE 개체를 해제하려면
DdeClientTransaction 함수에서 받은 애플리케이션을 처리하는 DDE 개체를 해제하려면

시스템은 핸들이 DDE 콜백 함수에 의해 반환되거나 DDEML 함수에서 매개 변수로 사용될 때 소유되지 않은 개체를 자동으로 해제합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ddeml.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll