NetAddr_GetAddress 매크로(shellapi.h)

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

구문

void NetAddr_GetAddress(
             hwnd,
  [in, out]  pv
);

매개 변수

hwnd

유효성을 검사할 주소를 포함하는 네트워크 주소 컨트롤에 대한 핸들입니다.

[in, out] pv

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

반환 값

없음

설명

NetAddr_GetAddress 매크로를 사용하여 미리 설정된 네트워크 주소 유형 마스크에 대해 네트워크 주소 컨트롤의 네트워크 주소의 유효성을 검사합니다. 인스턴스화하려면 Shellapi.h에 정의된 클래스 msctls_netaddress 사용합니다. 이 매크로를 호출하기 전에 런타임에 InitNetworkAddressControl 을 호출합니다. 그러면 네트워크 주소 컨트롤이 포함된 공용 컨트롤 라이브러리가 초기화됩니다.

이 매크로는 네트워크 주소 컨트롤에서 네트워크 주소 문자열을 가져오고, 문자열을 구문 분석하고, 문자열이 네트워크 주소 형식 마스크와 일치하는지 확인합니다. 문자열이 마스크와 일치하는 경우 함수는 S_OK 반환하고 pv에서 가리키는 NC_ADDRESS 구조를 사용하여 구문 분석된 형식의 문자열을 호출 애플리케이션(포트 번호, 접두사 길이 및 기타 주소 정보 포함) 에 반환합니다. 호출하는 애플리케이션이 pv로 가리키는 구조를 할당하지 못하면 이 매크로는 E_INVALIDARG 반환합니다.

서비스 및 네트워크에 대한 IP(인터넷 프로토콜) 주소 버전 4 및 6(v4/v6)과 DNS(도메인 이름 시스템) 형식을 사용하는 명명된 인터넷 주소 및 서비스의 표현이 구문 분석됩니다. 네트워크 주소 문자열이 명명된 DNS(호스트 이름) 또는 서비스를 나타내는 경우 NC_ADDRESSPrefixLength 멤버에 반환된 값은 0입니다.

NetAddr_GetAddress 매크로를 호출하기 전에 NetAddr_SetAllowType매크로를 사용하여 네트워크 주소 유형 마스크를 설정합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h

추가 정보

NetAddr_GetAllowType