共用方式為

IMbnInterface：：SetPreferredProviders 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

更新裝置的慣用提供者清單。

語法

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

參數

[in] preferredProviders

包含慣用提供者清單的 MBN_PROVIDER 結構陣列。

[out] requestID

此要求的作業系統所設定之要求識別碼的指標。 非同步回應將包含這個相同的 requestID。

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
行動寬頻服務未在此系統上執行。
E_HANDLE
 介面無效，最有可能是因為行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
介面無效。 最有可能是因為行動寬頻裝置已從系統中移除。

備註

SetPreferredProviders方法會起始介面慣用提供者清單的更新。 這是非同步作業，而方法呼叫會立即傳回。 如果此方法傳回成功 (S_OK) ，則作業系統會藉由呼叫IMbnInterfaceEvents的OnSetPreferredProvidersComplete方法，通知呼叫呼叫端應用程式此作業的完成狀態。

如果在完成此作業之前從系統移除裝置，則不會保證呼叫端應用程式會收到完成通知。

需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnInterface