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。
分析 Internet 协议 (IP) 地址版本 4 和 6 (v4/v6) ，以及使用域名系统 (DNS) 格式的命名 Internet 地址和服务。 如果网络地址字符串表示 dns) 或服务 (命名主机名，则 NC_ADDRESS 的 PrefixLength 成员中返回的值为零。
在调用 NetAddr_GetAddress 宏之前，使用 NetAddr_SetAllowType宏设置 网络地址类型掩码。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shellapi.h |