IWSDiscoveryProvider：：SetAddressFamily 方法 (wsddisco.h)

指定要在探索 WSD 裝置時搜尋的 IP 位址系列 (IPv4、IPv6 或兩者) 。

語法

HRESULT SetAddressFamily(
  [in] DWORD dwAddressFamily
);

[in] dwAddressFamily

探索裝置時要搜尋的位址系列。

值	意義
WSDAPI_ADDRESSFAMILY_IPV4	搜尋 IPv4 位址。
WSDAPI_ADDRESSFAMILY_IPV6	搜尋 IPv6 位址。
WSDAPI_ADDRESSFAMILY_IPV4 \|WSDAPI_ADDRESSFAMILY_IPV6	搜尋 IPv4 和 IPv6 位址。

這個方法可以傳回其中一個值。

可能的傳回值包括，但不限於下列各項。

傳回碼	描述
S_OK	方法已順利完成。
E_INVALIDARG	dwAddressFamily 具有WSDAPI_ADDRESSFAMILY_IPV4、WSDAPI_ADDRESSFAMILY_IPV6或WSDAPI_ADDRESSFAMILY_IPV4以外的值 \|WSDAPI_ADDRESSFAMILY_IPV6。
STG_E_INVALIDFUNCTION	已為此發行者設定位址系列。
HRESULT_FROM_WIN32 (WSAESOCKTNOSUPPORT)	系統不支援 dwAddressFamily 指定的位址系列。

這個方法只能在提供者上呼叫一次。在通知接收附加至提供者之前，必須先呼叫這個方法。這表示必須先呼叫 SetAddressFamily ，才能在提供者上呼叫 Attach 。