NetMessageNameAdd 함수(lmmsg.h)
[이 함수는 메신저 서비스가 지원되지 않으므로 Windows Vista에서 지원되지 않습니다.]
NetMessageNameAdd 함수는 메시지 이름 테이블에 메시지 별칭을 등록합니다. 함수를 사용하려면 메신저 서비스를 시작해야 합니다.
구문
NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
[in] LPCWSTR servername,
[in] LPCWSTR msgname
);
매개 변수
[in] servername
함수를 실행할 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.
[in] msgname
추가할 메시지 별칭을 지정하는 상수 문자열에 대한 포인터입니다. 문자열의 길이는 15자를 초과할 수 없습니다.
반환 값
함수가 성공하면 반환 값이 NERR_Success.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다. |
|
매개 변수가 잘못되었습니다. |
|
이 요청은 지원되지 않습니다. 이 오류는 Windows Vista 이상에서 반환됩니다. |
|
이 컴퓨터에 메시지 별칭이 이미 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오. |
|
지정한 이름이 이미 네트워크에서 메시지 별칭으로 사용되고 있습니다. |
|
네트워크 하드웨어에서 일반적인 오류가 발생했습니다. |
|
최대 메시지 별칭 수를 초과했습니다. |
설명
관리자 로컬 그룹의 멤버만 원격 서버에서 NetMessageNameAdd 함수를 성공적으로 실행할 수 있습니다.
전달 작업 플래그는 더 이상 LAN 관리자 2에 대한 매개 변수가 아닙니다. 메시지 전달이 더 이상 지원되지 않으므로 x NetMessageNameAdd 함수입니다. NetMessageNameAdd 함수가 전달된 버전의 msgname이 네트워크에 있음을 감지하면 오류 NERR_Already_Exists 함께 함수가 실패합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | lmmsg.h(Lm.h 포함) |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |