DdeConnect 함수(ddeml.h)

아티클
02/29/2024

지정된 서비스 이름 및 토픽 이름 쌍을 지원하는 서버 애플리케이션과 대화를 설정합니다. 이러한 서버가 둘 이상 있는 경우 시스템은 하나만 선택합니다.

구문

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

매개 변수

[in] idInst

형식:DWORD

애플리케이션은 DdeInitialize 함수에 대한 이전 호출에서 얻은 식별자를 instance.

[in] hszService

형식: HSZ

대화를 설정할 서버 애플리케이션의 서비스 이름을 지정하는 문자열에 대한 핸들입니다. 이 핸들은 DdeCreateStringHandle 함수에 대한 이전 호출에 의해 만들어졌어야 합니다. 이 매개 변수가 0L이면 사용 가능한 모든 서버와 대화가 설정됩니다.

[in] hszTopic

형식: HSZ

대화를 설정할 토픽의 이름을 지정하는 문자열에 대한 핸들입니다. 이 핸들은 DdeCreateStringHandle에 대한 이전 호출에 의해 만들어졌어야 합니다. 이 매개 변수가 0L이면 선택한 서버에서 지원하는 모든 항목에 대한 대화가 설정됩니다.

[in, optional] pCC

형식: PCONVCONTEXT

대화 컨텍스트 정보를 포함하는 CONVCONTEXT 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 서버는 XTYP_CONNECT 또는 XTYP_WILDCONNECT 트랜잭션 중에 기본 CONVCONTEXT 구조를 받습니다.

반환 값

형식: HCONV

함수가 성공하면 반환 값은 설정된 대화에 대한 핸들입니다.

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

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

설명

클라이언트 애플리케이션은 선택한 서버에 대해 가정할 수 없습니다. hszService 매개 변수에 instance 특정 이름을 지정하면 지정된 instance 사용하여 대화가 설정됩니다. 인스턴스별 서비스 이름은 XTYP_REGISTER 및 XTYP_UNREGISTER 트랜잭션 중에 애플리케이션의 DDE(동적 데이터 교환) 콜백 함수에 전달됩니다.

기본 CONVCONTEXT 구조체의 모든 멤버는 구조체의 크기를 지정하는 cb를 제외하고 0으로 설정되며, 클라이언트 애플리케이션에서 ANSI 또는 유니코드 버전의 DdeInitialize 함수를 호출했는지 여부에 따라 CP_WINANSI(기본 코드 페이지) 또는 CP_WINUNICODE 지정하는 iCodePage가 있습니다.

요구 사항

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