Win32 API 日本語リファレンス
ホーム › NetworkManagement.MobileBroadband › IMbnMultiCarrier

IMbnMultiCarrier

COM
📘 Microsoft Learn (日本語) · English
IIDdcbbbab6-2020-4bbb-aaee-338e368af6fa継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetHomeProvider(MBN_PROVIDER2* homeProvider, DWORD* requestID)
homeProviderMBN_PROVIDER2*in設定するホームプロバイダー情報を格納したMBN_PROVIDER2構造体の入力ポインタ。
requestIDDWORD*out非同期設定要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 4 HRESULT GetPreferredProviders(SAFEARRAY** preferredMulticarrierProviders)
preferredMulticarrierProvidersSAFEARRAY**outマルチキャリアの優先プロバイダー一覧をSAFEARRAYで受け取る出力ポインタ。
vtbl 5 HRESULT GetVisibleProviders(DWORD* age, SAFEARRAY** visibleProviders)
ageDWORD*out返される可視プロバイダー情報の経過時間を秒単位で受け取る出力ポインタ。
visibleProvidersSAFEARRAY**out現在検出可能なプロバイダーの一覧をSAFEARRAYで受け取る出力ポインタ。
vtbl 6 HRESULT GetSupportedCellularClasses(SAFEARRAY** cellularClasses)
cellularClassesSAFEARRAY**outデバイスがサポートするセルラークラス(GSM・CDMA等)の一覧をSAFEARRAYで受け取る出力ポインタ。
vtbl 7 HRESULT GetCurrentCellularClass(MBN_CELLULAR_CLASS* currentCellularClass)
currentCellularClassMBN_CELLULAR_CLASS*out現在使用中のセルラークラスを示すMBN_CELLULAR_CLASS列挙値を受け取る出力ポインタ。
vtbl 8 HRESULT ScanNetwork(DWORD* requestID)
requestIDDWORD*outネットワークスキャン非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IMbnMultiCarrier "{DCBBBAB6-2020-4BBB-AAEE-338E368AF6FA}"
#usecom global IMbnMultiCarrier IID_IMbnMultiCarrier "{}"
#comfunc global IMbnMultiCarrier_SetHomeProvider              3 var,var
#comfunc global IMbnMultiCarrier_GetPreferredProviders        4 var
#comfunc global IMbnMultiCarrier_GetVisibleProviders          5 var,var
#comfunc global IMbnMultiCarrier_GetSupportedCellularClasses  6 var
#comfunc global IMbnMultiCarrier_GetCurrentCellularClass      7 var
#comfunc global IMbnMultiCarrier_ScanNetwork                  8 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。