다음을 통해 공유


NCM_GETADDRESS 메시지

네트워크 주소가 지정된 형식 및 형식을 준수하는지 여부를 나타냅니다.

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;            

            

매개 변수

wParam

0이어야 합니다.

pv [in, out]

*hwnd*로 지정된 컨트롤의 주소 형식 및 형식의 유효성을 검사하는 경우 구문 분석된 형식으로 네트워크 주소 정보를 수신하는 NC_ADDRESS 구조체 에 대한 포인터입니다. 호출 애플리케이션은 이 구조체에 대한 메모리를 할당합니다.

반환 값

HRESULT 형식의 다음 값 중 하나를 반환합니다.

반환 코드 설명
E_INVALIDARG
호출하는 애플리케이션이 NC_ADDRESS 구조를 할당하지 못했습니다.
ERROR_INSUFFICIENT_BUFFER
out 버퍼가 너무 작아 구문 분석된 네트워크 주소를 보유할 수 없습니다.
ERROR_INVALID_PARAMETER
네트워크 주소 문자열이 지정된 형식이 아닙니다.
ERROR_SUCCESS
작업이 완료되었습니다.
S_FALSE
네트워크 주소 컨트롤에 유효성을 검사할 주소가 없습니다.

 

설명

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 [데스크톱 앱만 해당]
헤더
Shellapi.h

추가 정보

NCM_GETALLOWTYPE

NetAddr_GetAddress