ILocation

COM

IIDab2ece69-56d9-4f28-b525-de1b0ee44237継承元IUnknown自前メソッド開始 vtbl3

メソッド 9

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

vtbl 3 HRESULT RegisterForReport(ILocationEvents* pEvents, GUID* reportType, DWORD dwRequestedReportInterval)

pEvents	ILocationEvents*	inoptional	位置変化や状態変化の通知を受け取るILocationEventsコールバック。
reportType	GUID*	in	登録するレポート種別を示すGUID(緯度経度または住所)。
dwRequestedReportInterval	DWORD	in	希望するレポート間隔(ミリ秒)。0で既定値。

vtbl 4 HRESULT UnregisterForReport(GUID* reportType)

reportType

GUID*

登録解除するレポート種別を示すGUID。

vtbl 5 HRESULT GetReport(GUID* reportType, ILocationReport** ppLocationReport)

reportType	GUID*	in	取得するレポート種別を示すGUID。
ppLocationReport	ILocationReport**	out	取得した位置レポートを受け取るILocationReportポインター。

vtbl 6 HRESULT GetReportStatus(GUID* reportType, LOCATION_REPORT_STATUS* pStatus)

reportType	GUID*	in	状態を取得するレポート種別を示すGUID。
pStatus	LOCATION_REPORT_STATUS*	out	レポートの現在の状態を受け取るLOCATION_REPORT_STATUS。

vtbl 7 HRESULT GetReportInterval(GUID* reportType, DWORD* pMilliseconds)

reportType	GUID*	in	間隔を取得するレポート種別を示すGUID。
pMilliseconds	DWORD*	out	現在のレポート間隔を受け取るポインター(ミリ秒)。

vtbl 8 HRESULT SetReportInterval(GUID* reportType, DWORD millisecondsRequested)

reportType	GUID*	in	間隔を設定するレポート種別を示すGUID。
millisecondsRequested	DWORD	in	希望するレポート間隔(ミリ秒)。0で既定値。

vtbl 9 HRESULT GetDesiredAccuracy(GUID* reportType, LOCATION_DESIRED_ACCURACY* pDesiredAccuracy)

reportType	GUID*	in	精度を取得するレポート種別を示すGUID。
pDesiredAccuracy	LOCATION_DESIRED_ACCURACY*	out	現在の希望精度を受け取るLOCATION_DESIRED_ACCURACY。

vtbl 10 HRESULT SetDesiredAccuracy(GUID* reportType, LOCATION_DESIRED_ACCURACY desiredAccuracy)

reportType	GUID*	in	精度を設定するレポート種別を示すGUID。
desiredAccuracy	LOCATION_DESIRED_ACCURACY	in	希望する精度レベルを示すLOCATION_DESIRED_ACCURACY値。

vtbl 11 HRESULT RequestPermissions(HWND hParent, GUID* pReportTypes, DWORD count, BOOL fModal)

hParent	HWND	inoptional	権限要求ダイアログの親ウィンドウハンドル。
pReportTypes	GUID*	in	権限を要求するレポート種別GUIDの配列。
count	DWORD	in	pReportTypes配列の要素数。
fModal	BOOL	in	ダイアログをモーダル表示するかを示すBOOL。TRUEでモーダル。

HSP用 COM定義

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

出力引数:

#define global IID_ILocation "{AB2ECE69-56D9-4F28-B525-DE1B0EE44237}"
#usecom global ILocation IID_ILocation "{E5B8E079-EE6D-4E33-A438-C87F2E959254}"
#comfunc global ILocation_RegisterForReport    3 sptr,var,int
#comfunc global ILocation_UnregisterForReport  4 var
#comfunc global ILocation_GetReport            5 var,sptr
#comfunc global ILocation_GetReportStatus      6 var,var
#comfunc global ILocation_GetReportInterval    7 var,var
#comfunc global ILocation_SetReportInterval    8 var,int
#comfunc global ILocation_GetDesiredAccuracy   9 var,var
#comfunc global ILocation_SetDesiredAccuracy   10 var,int
#comfunc global ILocation_RequestPermissions   11 sptr,var,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ILocation "{AB2ECE69-56D9-4F28-B525-DE1B0EE44237}"
#usecom global ILocation IID_ILocation "{E5B8E079-EE6D-4E33-A438-C87F2E959254}"
#comfunc global ILocation_RegisterForReport    3 sptr,sptr,int
#comfunc global ILocation_UnregisterForReport  4 sptr
#comfunc global ILocation_GetReport            5 sptr,sptr
#comfunc global ILocation_GetReportStatus      6 sptr,sptr
#comfunc global ILocation_GetReportInterval    7 sptr,sptr
#comfunc global ILocation_SetReportInterval    8 sptr,int
#comfunc global ILocation_GetDesiredAccuracy   9 sptr,sptr
#comfunc global ILocation_SetDesiredAccuracy   10 sptr,int
#comfunc global ILocation_RequestPermissions   11 sptr,sptr,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。