NetAddr_GetAddress 매크로(shellapi.h)

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

문법

HRESULT NetAddr_GetAddress(
             HWND hwnd,
  [in, out]  LPARAM pv
);

매개 변수

hwnd

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

[in, out] pv

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

반환 값

형식: HRESULT

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

• E_INVALIDARG - 호출하는 애플리케이션이 NC_ADDRESS 구조를 할당하지 못했습니다.
• ERROR_INSUFFICIENT_BUFFER - 아웃 버퍼가 너무 작아 구문 분석된 네트워크 주소를 보유할 수 없습니다.
• ERROR_INVALID_PARAMETER - 네트워크 주소 문자열이 지정된 형식이 아닙니다.
• ERROR_SUCCESS - 작업이 성공했습니다.
• S_FALSE - 유효성을 검사할 네트워크 주소 제어에 주소가 없습니다.

비고

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매크로를 사용하여 네트워크 주소 유형 마스크를 설정합니다.

요구 사항

참고하십시오

NetAddr_GetAllowType