Share via

NCM_GETADDRESS消息

  • 项目

指示网络地址是否符合指定的类型和格式。

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;

参数

wParam

必须为零。

pv [in， out]

如果验证了 *hwnd* 指定的控件中的地址格式和类型，则指向 NC_ADDRESS结构的指针 ，以分析的形式接收网络地址信息。 调用应用程序负责为此结构分配内存。

返回值

返回 HRESULT 类型的以下值之一。

返回代码 说明
E_INVALIDARG
 调用应用程序未能分配 NC_ADDRESS 结构。
ERROR_INSUFFICIENT_BUFFER
 输出缓冲区太小，无法容纳分析的网络地址。
ERROR_INVALID_PARAMETER
 网络地址字符串不是指定的任何类型。
ERROR_SUCCESS
 操作成功。
S_FALSE
 网络地址控件中没有要验证的地址。

 

备注

使用 NCM_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 成员中返回的值为零。

在发送NCM_GETADDRESS宏之前，使用NCM_SETALLOWTYPE消息设置网络地址类型掩码。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
Shellapi.h

请参阅

NCM_GETALLOWTYPE

NetAddr_GetAddress