DdeNameService 함수(ddeml.h)

아티클
08/23/2023

DDE(동적 데이터 교환) 서버에서 지원하는 서비스 이름을 등록하거나 등록 취소합니다. 이 함수는 시스템이 실행 중인 다른 DDEML(동적 데이터 교환 관리 라이브러리) 클라이언트 애플리케이션에 XTYP_REGISTER 또는 XTYP_UNREGISTER 트랜잭션을 보내도록 합니다.

구문

HDDEDATA DdeNameService(
  [in]           DWORD idInst,
  [in, optional] HSZ   hsz1,
  [in, optional] HSZ   hsz2,
  [in]           UINT  afCmd
);

매개 변수

[in] idInst

형식:DWORD

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

[in, optional] hsz1

형식: HSZ

서버가 등록하거나 등록 취소하는 서비스 이름을 지정하는 문자열에 대한 핸들입니다. 모든 서비스 이름을 등록 취소하는 애플리케이션은 이 매개 변수를 0L로 설정해야 합니다.

[in, optional] hsz2

형식: HSZ

예약; 0L로 설정해야 합니다.

[in] afCmd

형식: UINT

서비스 이름 옵션입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
DNS_REGISTER 0x0001	오류 코드 서비스 이름을 등록합니다.
DNS_UNREGISTER 0x0002	오류 코드 서비스 이름을 등록 취소합니다. hsz1 매개 변수가 0L이면 서버에서 등록한 모든 서비스 이름이 등록 취소됩니다.
DNS_FILTERON 0x0004	서비스 이름 시작 필터링을 켭니다. 필터를 사용하면 서버가 등록되지 않은 서비스 이름에 대한 XTYP_CONNECT 트랜잭션을 수신할 수 없습니다. 이 필터의 기본 설정입니다. 서버 애플리케이션이 서비스 이름을 등록하지 않으면 애플리케이션은 XTYP_WILDCONNECT 트랜잭션을 받을 수 없습니다.
DNS_FILTEROFF 0x0008	서비스 이름 시작 필터링을 해제합니다. 이 플래그를 지정하면 서버는 서비스 이름에 관계없이 다른 DDE 애플리케이션이 DdeConnect 함수를 호출할 때마다 XTYP_CONNECT 트랜잭션을 받습니다.

반환 값

형식: HDDEDATA

함수가 성공하면 0이 아닌 값을 반환합니다. 이 값은 진정한 HDDEDATA 값이 아니라 단지 성공의 부울 지표일 뿐입니다. 함수는 함수의 향후 확장 가능 및 보다 정교한 반환 값을 허용하도록 HDDEDATA 형식입니다.

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

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

설명

hsz1 매개 변수로 식별된 서비스 이름은 기본 이름이어야 합니다(즉, 이름에 instance 관련 정보가 없어야 합니다). 시스템은 instance 특정 이름을 생성하고 XTYP_REGISTER 및 XTYP_UNREGISTER 트랜잭션 중에 기본 이름과 함께 보냅니다. 그러면 수신 애플리케이션이 특정 애플리케이션 instance 연결할 수 있습니다.

요구 사항


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