IMbnServiceActivation::Activate メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する 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

この操作の要求 ID。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
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 メソッドを呼び出します。