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

另請參閱

NetAddr_GetAllowType