DdeNameService 함수(ddeml.h)
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
서비스 이름 옵션입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
오류 코드 서비스 이름을 등록합니다. |
|
오류 코드 서비스 이름을 등록 취소합니다. hsz1 매개 변수가 0L이면 서버에서 등록한 모든 서비스 이름이 등록 취소됩니다. |
|
서비스 이름 시작 필터링을 켭니다. 필터를 사용하면 서버가 등록되지 않은 서비스 이름에 대한 XTYP_CONNECT 트랜잭션을 수신할 수 없습니다. 이 필터의 기본 설정입니다.
서버 애플리케이션이 서비스 이름을 등록하지 않으면 애플리케이션은 XTYP_WILDCONNECT 트랜잭션을 받을 수 없습니다. |
|
서비스 이름 시작 필터링을 해제합니다. 이 플래그를 지정하면 서버는 서비스 이름에 관계없이 다른 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 |
추가 정보
개념
참조