NCM_GETADDRESS 메시지
네트워크 주소가 지정된 형식 및 형식을 준수하는지 여부를 나타냅니다.
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
매개 변수
-
wParam
- 0이어야 합니다.
-
pv [in, out]
- *hwnd*로 지정된 컨트롤의 주소 형식 및 형식의 유효성을 검사하는 경우 구문 분석된 형식으로 네트워크 주소 정보를 수신하는 NC_ADDRESS 구조체 에 대한 포인터입니다. 호출 애플리케이션은 이 구조체에 대한 메모리를 할당합니다.
반환 값
HRESULT 형식의 다음 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
호출하는 애플리케이션이 NC_ADDRESS 구조를 할당하지 못했습니다. |
|
out 버퍼가 너무 작아 구문 분석된 네트워크 주소를 보유할 수 없습니다. |
|
네트워크 주소 문자열이 지정된 형식이 아닙니다. |
|
작업이 완료되었습니다. |
|
네트워크 주소 컨트롤에 유효성을 검사할 주소가 없습니다. |
설명
NCM_GETADDRESS 메시지를 사용하여 미리 설정된 네트워크 주소 유형 마스크에 대해 네트워크 주소 컨트롤의 네트워크 주소 유효성을 검사합니다. 인스턴스화하려면 Shellapi.h에 정의된 클래스 msctls_netaddress 사용합니다. 이 메시지를 보내기 전에 런타임에 InitNetworkAddressControl 을 호출합니다. 이렇게 하면 네트워크 주소 컨트롤이 포함된 공용 컨트롤 라이브러리가 초기화됩니다.
이 메시지는 네트워크 주소 컨트롤에서 네트워크 주소 문자열을 가져오고, 문자열을 구문 분석하고, 문자열이 네트워크 주소 유형 마스크와 일치하는지 확인합니다. 문자열이 마스크와 일치하면 메시지는 S_OK 반환하고 pv가 가리키는 NC_ADDRESS 구조를 사용하여 구문 분석된 형식의 문자열을 호출 애플리케이션(포트 번호, 접두사 길이 및 기타 주소 정보 포함) 에 반환합니다. 호출하는 애플리케이션이 pv로 가리키는 구조를 할당하지 못하면 이 메시지는 E_INVALIDARG 반환합니다.
서비스 및 네트워크에 대한 IP(인터넷 프로토콜) 주소 버전 4 및 6(v4/v6)과 DNS(Domain Name System) 형식을 사용하는 명명된 인터넷 주소 및 서비스의 표현이 구문 분석됩니다. 네트워크 주소 문자열이 명명된 DNS(호스트 이름) 또는 서비스를 나타내는 경우 NC_ADDRESSPrefixLength 멤버에 반환된 값은 0입니다.
NCM_GETADDRESS 매크로를 보내기 전에 NCM_SETALLOWTYPE 메시지를 사용하여 네트워크 주소 유형 마스크를 설정합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
헤더 |
|
추가 정보