Win32 API 日本語リファレンス
ホームDevices.Tapi › ITLocationInfo

ITLocationInfo

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID0c4d8eff-8ddb-11d1-a09e-00805fc147d3継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 11

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_PermanentLocationID(INT* plLocationID)
plLocationIDINT*out所在地を一意に識別する永続的な所在地IDを受け取る。
vtbl 8 HRESULT get_CountryCode(INT* plCountryCode)
plCountryCodeINT*outこの所在地の国番号を受け取る。
vtbl 9 HRESULT get_CountryID(INT* plCountryID)
plCountryIDINT*outこの所在地の国/地域ID(TAPI内部の国識別子)を受け取る。
vtbl 10 HRESULT get_Options(INT* plOptions)
plOptionsINT*out所在地のオプションフラグ(トーン/パルス等)を受け取る。
vtbl 11 HRESULT get_PreferredCardID(INT* plCardID)
plCardIDINT*outこの所在地で優先使用するテレフォニーカードのIDを受け取る。
vtbl 12 HRESULT get_LocationName(LPWSTR* ppLocationName)
ppLocationNameLPWSTR*out所在地の名称文字列を受け取る出力先。呼び出し側で解放する。
vtbl 13 HRESULT get_CityCode(LPWSTR* ppCode)
ppCodeLPWSTR*out所在地の市外局番(エリアコード)を受け取る出力先。呼び出し側で解放する。
vtbl 14 HRESULT get_LocalAccessCode(LPWSTR* ppCode)
ppCodeLPWSTR*out市内通話発信時に必要な外線アクセスコードを受け取る出力先。呼び出し側で解放する。
vtbl 15 HRESULT get_LongDistanceAccessCode(LPWSTR* ppCode)
ppCodeLPWSTR*out長距離通話発信時に必要な外線アクセスコードを受け取る出力先。呼び出し側で解放する。
vtbl 16 HRESULT get_TollPrefixList(LPWSTR* ppTollList)
ppTollListLPWSTR*out市外料金扱いとなる局番のプレフィックス一覧を受け取る出力先。呼び出し側で解放する。
vtbl 17 HRESULT get_CancelCallWaitingCode(LPWSTR* ppCode)
ppCodeLPWSTR*outキャッチホン(コールウェイティング)を解除するためのコードを受け取る出力先。呼び出し側で解放する。

HSP用 COM定義

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

出力引数:
#define global IID_ITLocationInfo "{0C4D8EFF-8DDB-11D1-A09E-00805FC147D3}"
#usecom global ITLocationInfo IID_ITLocationInfo "{}"
#comfunc global ITLocationInfo_get_PermanentLocationID     7 var
#comfunc global ITLocationInfo_get_CountryCode             8 var
#comfunc global ITLocationInfo_get_CountryID               9 var
#comfunc global ITLocationInfo_get_Options                 10 var
#comfunc global ITLocationInfo_get_PreferredCardID         11 var
#comfunc global ITLocationInfo_get_LocationName            12 var
#comfunc global ITLocationInfo_get_CityCode                13 var
#comfunc global ITLocationInfo_get_LocalAccessCode         14 var
#comfunc global ITLocationInfo_get_LongDistanceAccessCode  15 var
#comfunc global ITLocationInfo_get_TollPrefixList          16 var
#comfunc global ITLocationInfo_get_CancelCallWaitingCode   17 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。