指出網路位址是否符合指定的類型和格式。
語法
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 成員中傳回的值為零。
在您呼叫 NetAddr_GetAddress 巨集之前，請先使用 NetAddr_SetAllowType 巨集來設定網路位址類型遮罩。
需求
| 要求 | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 頁首 | shellapi.h |