(mbnapi.h) IMbnServiceActivation：：Activate 方法

重要

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

將服務啟用要求傳送至網路。

語法

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

[in] vendorSpecificData

在服務啟用作業中傳遞的位元組廠商特定數位。此數據將會由行動寬頻服務在 SET OID_WWAN_SERVICE_ACTIVATION OID 要求中傳遞至迷你埠驅動程式。

[out] requestID

這項作業的要求標識碼。

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

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

應用程式可以使用 Activate 方法來啟用行動資料服務。在此要求中傳遞的數據格式是廠商特定的。

OID 要求的 VendorSpecificBufferSize 字段會設定為 SAFEARRAY vendorSpecificData 中的數據大小。 vendorSpecificData 的內容將會在 OID 要求中逐位元組複製到驅動程式。

如需服務啟用作業的詳細資訊，請參閱行動寬頻驅動程式模型。

這是會立即傳回的異步操作。如果方法傳回時沒有錯誤，則行動寬頻服務會呼叫 IMbnServiceActivationEvents 介面的 OnActivationComplete 方法。