DdeConnectList 함수(ddeml.h)

아티클
08/23/2023

지정된 서비스 이름 및 토픽 이름 쌍을 지원하는 모든 서버 애플리케이션과 대화를 설정합니다. 또한 애플리케이션은 이 함수를 사용하여 기존 대화 핸들 함수를 전달하여 대화 핸들 목록을 가져올 수도 있습니다. 동적 데이터 교환 관리 라이브러리는 대화 목록에서 종료된 대화의 핸들을 제거합니다. 결과 대화 목록에는 지정된 서비스 이름 및 토픽 이름을 지원하는 현재 설정된 모든 대화의 핸들이 포함됩니다.

구문

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

매개 변수

[in] idInst

형식:DWORD

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

[in] hszService

형식: HSZ

대화를 설정할 서버 애플리케이션의 서비스 이름을 지정하는 문자열에 대한 핸들입니다. 이 매개 변수가 0L인 경우 시스템은 지정된 토픽 이름을 지원하는 사용 가능한 모든 서버와 대화를 설정하려고 시도합니다.

[in] hszTopic

형식: HSZ

대화를 설정할 토픽의 이름을 지정하는 문자열에 대한 핸들입니다. 이 핸들은 DdeCreateStringHandle 함수에 대한 이전 호출에 의해 만들어졌어야 합니다. 이 매개 변수가 0L인 경우 시스템은 선택한 서버(또는 서버)에서 지원하는 모든 topics 대화를 설정하려고 시도합니다.

[in] hConvList

형식: HCONVLIST

열거할 대화 목록에 대한 핸들입니다. 새 대화 목록을 설정할 경우 이 매개 변수는 0L이어야 합니다.

[in, optional] pCC

형식: PCONVCONTEXT

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

반환 값

형식: HCONVLIST

함수가 성공하면 반환 값은 새 대화 목록에 대한 핸들입니다.

함수가 실패하면 반환 값은 0L입니다. 이전 대화 목록에 대한 핸들이 더 이상 유효하지 않습니다.

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

설명

애플리케이션은 목록 내의 대화 핸들이 활성 상태인지 여부에 관계없이 DdeConnectList 함수에서 반환된 대화 목록 핸들을 해제해야 합니다. 핸들을 해제하기 위해 애플리케이션은 DdeDisconnectList를 호출할 수 있습니다.

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

요구 사항

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