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

IMbnRegistration

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

メソッド 10

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

vtbl 3 HRESULT GetRegisterState(MBN_REGISTER_STATE* registerState)
registerStateMBN_REGISTER_STATE*outネットワーク登録状態(未登録・ホーム・ローミング等)を示す列挙値を受け取る出力ポインタ。
vtbl 4 HRESULT GetRegisterMode(MBN_REGISTER_MODE* registerMode)
registerModeMBN_REGISTER_MODE*out登録モード(自動・手動)を示す列挙値を受け取る出力ポインタ。
vtbl 5 HRESULT GetProviderID(LPWSTR* providerID)
providerIDLPWSTR*out現在登録中のプロバイダーID文字列を受け取る出力ポインタ。呼び出し側が解放する。
vtbl 6 HRESULT GetProviderName(LPWSTR* providerName)
providerNameLPWSTR*out現在登録中のプロバイダー名文字列を受け取る出力ポインタ。呼び出し側が解放する。
vtbl 7 HRESULT GetRoamingText(LPWSTR* roamingText)
roamingTextLPWSTR*outローミング時に表示するテキスト文字列を受け取る出力ポインタ。呼び出し側が解放する。
vtbl 8 HRESULT GetAvailableDataClasses(DWORD* availableDataClasses)
availableDataClassesDWORD*out利用可能なデータクラス(GPRS/UMTS/LTE等)のビットフラグ集合を受け取る出力ポインタ。
vtbl 9 HRESULT GetCurrentDataClass(DWORD* currentDataClass)
currentDataClassDWORD*out現在使用中のデータクラスを示すビットフラグを受け取る出力ポインタ。
vtbl 10 HRESULT GetRegistrationNetworkError(DWORD* registrationNetworkError)
registrationNetworkErrorDWORD*out登録時に発生したネットワークエラーコードを受け取る出力ポインタ。
vtbl 11 HRESULT GetPacketAttachNetworkError(DWORD* packetAttachNetworkError)
packetAttachNetworkErrorDWORD*outパケットアタッチ時に発生したネットワークエラーコードを受け取る出力ポインタ。
vtbl 12 HRESULT SetRegisterMode(MBN_REGISTER_MODE registerMode, LPWSTR providerID, DWORD dataClass, DWORD* requestID)
registerModeMBN_REGISTER_MODEin設定する登録モード(自動・手動)を指定する列挙値の入力。
providerIDLPWSTRin手動登録時に接続するプロバイダーのID文字列の入力。自動時はNULL可。
dataClassDWORDin登録に使用するデータクラスを指定するビットフラグの入力。
requestIDDWORD*out非同期登録要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。

HSP用 COM定義

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

出力引数: 
#define global IID_IMbnRegistration "{DCBBBAB6-2009-4BBB-AAEE-338E368AF6FA}"
#usecom global IMbnRegistration IID_IMbnRegistration "{}"
#comfunc global IMbnRegistration_GetRegisterState             3 var
#comfunc global IMbnRegistration_GetRegisterMode              4 var
#comfunc global IMbnRegistration_GetProviderID                5 var
#comfunc global IMbnRegistration_GetProviderName              6 var
#comfunc global IMbnRegistration_GetRoamingText               7 var
#comfunc global IMbnRegistration_GetAvailableDataClasses      8 var
#comfunc global IMbnRegistration_GetCurrentDataClass          9 var
#comfunc global IMbnRegistration_GetRegistrationNetworkError  10 var
#comfunc global IMbnRegistration_GetPacketAttachNetworkError  11 var
#comfunc global IMbnRegistration_SetRegisterMode              12 int,wstr,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。