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成員中所傳回的值為零。
呼叫NetAddr_GetAddress宏之前，請先使用NetAddr_SetAllowType宏來設定網路位址類型遮罩。
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shellapi.h |