PFNCALLBACK 콜백 함수(ddeml.h)

아티클
08/23/2023

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

현재 트랜잭션의 형식입니다. 이 매개 변수는 트랜잭션 클래스 플래그와 트랜잭션 형식 플래그의 조합으로 구성됩니다. 다음 표에서는 각 트랜잭션 클래스에 대해 설명하고 각 클래스의 트랜잭션 형식 목록을 제공합니다. 특정 트랜잭션 유형에 대한 자세한 내용은 주의에서 해당 형식에 대한 개별 설명을 참조 하세요.

[in] wFmt

형식: UINT

데이터를 보내거나 받는 형식입니다.

[in] hConv

형식: HCONV

현재 트랜잭션과 연결된 대화에 대한 핸들입니다.

[in] hsz1

형식: HSZ

문자열에 대한 핸들입니다. 이 매개 변수의 의미는 현재 트랜잭션의 형식에 따라 달라집니다. 이 매개 변수의 의미는 주의에서 트랜잭션 형식에 대한 설명을 참조 하세요.

[in] hsz2

형식: HSZ

[in] hData

형식: HDDEDATA

DDE 데이터에 대한 핸들입니다. 이 매개 변수의 의미는 현재 트랜잭션의 형식에 따라 달라집니다. 이 매개 변수의 의미는 주의에서 트랜잭션 형식에 대한 설명을 참조 하세요.

[in] dwData1

형식: ULONG_PTR

트랜잭션별 데이터입니다. 이 매개 변수의 의미는 주의에서 트랜잭션 형식에 대한 설명을 참조 하세요.

[in] dwData2

형식: ULONG_PTR

트랜잭션별 데이터입니다. 이 매개 변수의 의미는 주의에서 트랜잭션 형식에 대한 설명을 참조 하세요.

반환 값

형식: HDDEDATA

반환 값은 트랜잭션 클래스에 따라 달라집니다. 반환 값에 대한 자세한 내용은 개별 트랜잭션 형식에 대한 설명을 참조하세요.

설명

XCLASS_BOOL

DDE 콜백 함수는 이 클래스에 속한 트랜잭션 처리를 완료할 때 TRUE 또는 FALSE 를 반환해야 합니다. XCLASS_BOOL 트랜잭션 클래스는 다음 형식으로 구성됩니다.

XCLASS_DATA

DDE 콜백 함수는 이 클래스에 속한 트랜잭션 처리를 완료할 때 DDE 핸들, CBR_BLOCK 반환 코드 또는 NULL 을 반환해야 합니다. XCLASS_DATA 트랜잭션 클래스는 다음 형식으로 구성됩니다.

XCLASS_FLAGS

DDE 콜백 함수는 이 클래스에 속한 트랜잭션 처리를 완료할 때 DDE_FACK,DDE_FBUSY 또는 DDE_FNOTPROCESSED 반환해야 합니다. XCLASS_FLAGS 트랜잭션 클래스는 다음 형식으로 구성됩니다.

XCLASS_NOTIFICATION

이 클래스에 속하는 트랜잭션 형식은 알림 용도로만 사용됩니다. 콜백 함수의 반환 값은 무시됩니다. XCLASS_NOTIFICATION 트랜잭션 클래스는 다음 형식으로 구성됩니다.

콜백 함수는 대화를 만들거나 종료하지 않는 트랜잭션에 대해 비동기적으로 호출됩니다. 들어오는 메시지를 자주 수락하지 않는 애플리케이션은 DDEML(동적 데이터 교환 관리 라이브러리)에서 메시지를 사용하여 트랜잭션을 시작하기 때문에 DDE 성능이 저하됩니다.

애플리케이션은 DdeInitialize 함수에 대한 호출에서 함수에 대한 포인터를 지정하여 콜백 함수를 등록해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ddeml.h(Windows.h 포함)

추가 정보

개념

DdeEnableCallback

DdeInitialize

동적 데이터 교환 관리 라이브러리

다음을 통해 공유