Win32 API 日本語リファレンス
ホーム › Data.Xml.MsXml › IXMLHTTPRequest

IXMLHTTPRequest

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

メソッド 14

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

vtbl 7 HRESULT open(LPWSTR bstrMethod, LPWSTR bstrUrl, VARIANT varAsync, VARIANT bstrUser, VARIANT bstrPassword)
bstrMethodLPWSTRinHTTPメソッド名(GET,POST等)。
bstrUrlLPWSTRinリクエスト先のURL。
varAsyncVARIANTin非同期実行するかを指定するVARIANT(真偽)。既定はTRUEで非同期。
bstrUserVARIANTin認証に用いるユーザー名を表すVARIANT。不要ならVT_EMPTY。
bstrPasswordVARIANTin認証に用いるパスワードを表すVARIANT。不要ならVT_EMPTY。
vtbl 8 HRESULT setRequestHeader(LPWSTR bstrHeader, LPWSTR bstrValue)
bstrHeaderLPWSTRin設定するHTTPリクエストヘッダーの名前。
bstrValueLPWSTRinリクエストヘッダーに設定する値。
vtbl 9 HRESULT getResponseHeader(LPWSTR bstrHeader, LPWSTR* pbstrValue)
bstrHeaderLPWSTRin値を取得するレスポンスヘッダーの名前。
pbstrValueLPWSTR*out指定ヘッダーの値を受け取るBSTRポインタ。
vtbl 10 HRESULT getAllResponseHeaders(LPWSTR* pbstrHeaders)
pbstrHeadersLPWSTR*out全レスポンスヘッダーをまとめた文字列を受け取るBSTRポインタ。
vtbl 11 HRESULT send(VARIANT varBody)
varBodyVARIANTin送信するリクエスト本文を表すVARIANT。本文なしはVT_EMPTY等。
vtbl 12 HRESULT abort()
vtbl 13 HRESULT get_status(INT* plStatus)
plStatusINT*outHTTPステータスコード(200等)を受け取る出力。
vtbl 14 HRESULT get_statusText(LPWSTR* pbstrStatus)
pbstrStatusLPWSTR*outHTTPステータスの説明文字列(OK等)を受け取るBSTRポインタ。
vtbl 15 HRESULT get_responseXML(IDispatch** ppBody)
ppBodyIDispatch**outレスポンス本文を解析したXML文書のIDispatchを受け取る出力ポインタ。
vtbl 16 HRESULT get_responseText(LPWSTR* pbstrBody)
pbstrBodyLPWSTR*outレスポンス本文を文字列として受け取るBSTRポインタ。
vtbl 17 HRESULT get_responseBody(VARIANT* pvarBody)
pvarBodyVARIANT*outレスポンス本文を生バイト配列(SAFEARRAY)として格納するVARIANT出力。
vtbl 18 HRESULT get_responseStream(VARIANT* pvarBody)
pvarBodyVARIANT*outレスポンス本文をIStreamとして格納するVARIANT出力。
vtbl 19 HRESULT get_readyState(INT* plState)
plStateINT*outリクエストの状態(0:未初期化〜4:完了)を受け取る出力。
vtbl 20 HRESULT put_onreadystatechange(IDispatch* pReadyStateSink)
pReadyStateSinkIDispatch*in状態変化時に通知を受けるコールバックのIDispatch。

HSP用 COM定義

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

出力引数: 
#define global IID_IXMLHTTPRequest "{ED8C108D-4349-11D2-91A4-00C04F7969E8}"
#usecom global IXMLHTTPRequest IID_IXMLHTTPRequest "{ED8C108E-4349-11D2-91A4-00C04F7969E8}"
#comfunc global IXMLHTTPRequest_open                    7 wstr,wstr,int,int,int
#comfunc global IXMLHTTPRequest_setRequestHeader        8 wstr,wstr
#comfunc global IXMLHTTPRequest_getResponseHeader       9 wstr,var
#comfunc global IXMLHTTPRequest_getAllResponseHeaders   10 var
#comfunc global IXMLHTTPRequest_send                    11 int
#comfunc global IXMLHTTPRequest_abort                   12
#comfunc global IXMLHTTPRequest_get_status              13 var
#comfunc global IXMLHTTPRequest_get_statusText          14 var
#comfunc global IXMLHTTPRequest_get_responseXML         15 sptr
#comfunc global IXMLHTTPRequest_get_responseText        16 var
#comfunc global IXMLHTTPRequest_get_responseBody        17 var
#comfunc global IXMLHTTPRequest_get_responseStream      18 var
#comfunc global IXMLHTTPRequest_get_readyState          19 var
#comfunc global IXMLHTTPRequest_put_onreadystatechange  20 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。