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 |