CONVINFO 구조체(ddeml.h)

DDE(동적 데이터 교환) 대화에 대한 정보를 포함합니다.

구문

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

멤버

cb

형식:DWORD

구조체의 크기(바이트)입니다.

hUser

형식: DWORD_PTR

애플리케이션 정의 데이터입니다.

hConvPartner

형식: HCONV

DDE 대화에서 파트너 애플리케이션에 대한 핸들입니다. 파트너가 DDEML 함수를 호출하기 위해 자신을 등록하지 않은 경우( DdeInitialize 함수 사용) 이 멤버는 0입니다. 애플리케이션은 DdeQueryConvInfo를 제외한 모든 DDEML 함수에 이 멤버를 전달해서는 안 됩니다.

hszSvcPartner

형식: HSZ

파트너 애플리케이션의 서비스 이름에 대한 핸들입니다.

hszServiceReq

형식: HSZ

연결을 요청한 서버 애플리케이션의 서비스 이름에 대한 핸들입니다.

hszTopic

형식: HSZ

요청된 토픽의 이름에 대한 핸들입니다.

hszItem

형식: HSZ

요청된 항목의 이름에 대한 핸들입니다. 이 멤버는 트랜잭션에 따라 다릅니다.

wFmt

형식: UINT

교환되는 데이터의 형식입니다. 이 멤버는 트랜잭션에 따라 다릅니다.

wType

형식: UINT

현재 트랜잭션의 형식입니다. 이 멤버는 트랜잭션에 따라 다릅니다. 다음 값 중 하나일 수 있습니다.

의미
XTYP_ADVDATA
0x4010
서버의 데이터가 도착했음을 알리는 클라이언트에 알릴 수 있습니다.
XTYP_ADVREQ
0x2022
서버가 advise 루프 중에 업데이트된 데이터를 클라이언트에 보내도록 요청합니다. 이 트랜잭션은 서버가 DdePostAdvise를 호출할 때 발생합니다.
XTYP_ADVSTART
0x1030
클라이언트를 사용하여 조언 루프를 시작하도록 서버에 요청합니다.
XTYP_ADVSTOP
0x8040
서버에 advise 루프가 중지되고 있음을 알 수 있습니다.
XTYP_CONNECT
0x1062
서버에 클라이언트와의 대화를 설정하도록 요청합니다.
XTYP_CONNECT_CONFIRM
0x8072
서버에 클라이언트와의 대화가 설정되었음을 알 수 있습니다.
XTYP_DISCONNECT
0x80C2
서버에 대화가 종료되었음을 알 수 있습니다.
XTYP_EXECUTE
0x4050
클라이언트에서 보낸 명령을 실행하도록 서버에 요청합니다.
XTYP_MONITOR
0x80F2
APPCMD_MONITOR 등록된 애플리케이션에 DDE 데이터가 전송되고 있음을 알 수 있습니다.
XTYP_POKE
0x4090
클라이언트에서 원치 않는 데이터를 수락하도록 서버에 요청합니다.
XTYP_REGISTER
0x80A2
서버가 서비스 이름을 등록했음을 다른 DDEML 애플리케이션에 알린 것입니다.
XTYP_REQUEST
0x20B0
클라이언트에 데이터를 보내도록 서버에 요청합니다.
XTYP_UNREGISTER
0x80D2
서버가 서비스 이름을 등록 취소했음을 다른 DDEML 애플리케이션에 알린 것입니다.
XTYP_WILDCONNECT
0x20E2
서버에 동일한 클라이언트와 여러 대화를 설정하도록 요청합니다.
XTYP_XACT_COMPLETE
0x8080
클라이언트에 비동기 데이터 트랜잭션이 완료되었음을 알 수 있습니다.

wStatus

형식: UINT

현재 대화의 상태. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

의미
ST_ADVISE
0x0002
하나 이상의 링크가 진행 중입니다.
ST_BLOCKED
0x0008
대화가 차단됩니다.
ST_BLOCKNEXT
0x0080
다음 콜백을 호출한 후 대화가 차단됩니다.
ST_CLIENT
0x0010
DdeQueryConvInfo 함수에 전달된 con0x0010versation 핸들은 클라이언트 쪽 핸들입니다. 핸들이 0이면 DdeQueryConvInfo 함수에 전달된 대화 핸들은 서버 쪽 핸들입니다.
ST_CONNECTED
0x0001
대화가 연결되었습니다.
ST_INLIST
0x0040
대화는 대화 목록의 구성원입니다.
ST_ISLOCAL
0x0004
대화의 양쪽에서 DDEML을 사용하고 있습니다.
ST_ISSELF
0x0100
대화의 양쪽 모두 DDEML의 동일한 instance 사용하고 있습니다.
ST_TERMINATED
0x0020
파트너가 대화를 종료했습니다.

wConvst

형식: UINT

대화 상태입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

의미
XST_ADVACKRCVD
13
자문 거래가 방금 완료되었습니다.
XST_ADVDATAACKRCVD
16
자문 데이터 트랜잭션이 방금 완료되었습니다.
XST_ADVDATASENT
15
조언 데이터가 전송되어 승인을 기다리고 있습니다.
XST_ADVSENT
11
자문 트랜잭션이 승인을 기다리고 있습니다.
XST_CONNECTED
2
대화에 활성 트랜잭션이 없습니다.
XST_DATARCVD
6
요청된 데이터가 방금 수신되었습니다.
XST_EXECACKRCVD
10
실행 트랜잭션이 방금 완료되었습니다.
XST_EXECSENT
9
실행 트랜잭션이 승인을 기다리고 있습니다.
XST_INCOMPLETE
1
마지막 트랜잭션이 실패했습니다.
XST_INIT1
3
중간 시작 상태 1.
XST_INIT2
4
중간 시작 상태 2.
XST_NULL
0
사전 시작 상태입니다.
XST_POKEACKRCVD
8
찌르기 트랜잭션이 방금 완료되었습니다.
XST_POKESENT
7
포크 트랜잭션이 승인을 기다리고 있습니다.
XST_REQSENT
5
요청 트랜잭션이 승인을 기다리고 있습니다.
XST_UNADVACKRCVD
14
비관리 트랜잭션이 방금 완료되었습니다.
XST_UNADVSENT
12
unadvise 트랜잭션이 승인을 기다리고 있습니다.

wLastError

형식: UINT

마지막 트랜잭션과 연결된 오류 값입니다.

hConvList

형식: HCONVLIST

현재 대화에 대한 핸들이 대화 목록에 있는 경우 대화 목록에 대한 핸들입니다. 대화가 대화 목록에 없는 경우 이 멤버는 NULL 입니다.

ConvCtxt

형식: CONVCONTEXT

대화 컨텍스트입니다.

hwnd

형식: HWND

대화에 관련된 호출 애플리케이션의 창에 대한 핸들입니다.

hwndPartner

형식: HWND

현재 대화에 관련된 파트너 애플리케이션의 창에 대한 핸들입니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 ddeml.h(Windows.h 포함)

추가 정보

CONVCONTEXT

개념

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

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

참조