共用方式為


NCM_GETADDRESS訊息

指出網路位址是否符合指定的類型和格式。

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;            

            

參數

wParam

必須為零。

pv [in, out]

如果驗證了 *hwnd* 所指定控制項中的位址格式和類型,則為 NC_ADDRESS 結構的指標,以接收網路位址資訊。 呼叫的應用程式負責配置此結構的記憶體。

傳回值

傳回 HRESULT類型的下列其中一個值。

傳回碼 Description
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。

會剖析服務與網路的網際網路通訊協定 (IP) 位址版本 4 和 6 (v4/v6) ,以及使用網域名稱系統 (DNS) 格式的具名網際網路位址和服務。 如果網路位址字串代表 (DNS) 或服務的具名主機名稱,NC_ADDRESSPrefixLength成員中傳回的值是零。

在您傳送NCM_GETADDRESS宏之前,請先使用NCM_SETALLOWTYPE訊息來設定網路位址類型遮罩。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 [僅限傳統型應用程式]
標頭
Shellapi.h

另請參閱

NCM_GETALLOWTYPE

NetAddr_GetAddress