CONVINFO 구조체(ddeml.h)

아티클
08/23/2023

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 포함)