共用方式為

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