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

IWSDHttpAddress

COM
📘 Microsoft Learn (日本語) · English
IIDd09ac7bd-2a3e-4b85-8605-2737ff3e4ea0継承元IWSDTransportAddress自前メソッド開始 vtbl10

公式ドキュメント

HTTP アドレスの各構成要素へのアクセスを提供します。

メソッド 4

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

vtbl 10 HRESULT GetSecure()

このアドレスで TLS セキュアセッションが有効になっているかどうかの状態を取得します。

戻り値

このメソッドは次のいずれかの値を返します。

返される可能性のある値には、以下のものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 このアドレスで TLS セキュアセッションが有効になっています。
S_FALSE
 このアドレスで TLS セキュアセッションが無効になっています。
vtbl 11 HRESULT SetSecure(BOOL fSecure)

このアドレスの TLS セキュアセッションを有効または無効にします。

fSecureBOOLinこのアドレスで TLS セキュアセッション通信を有効にする場合は TRUE、TLS を無効にする場合は FALSE を指定します。

戻り値

このメソッドは次のいずれかの値を返します。

返される可能性のある値には、以下のものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
vtbl 12 HRESULT GetPath(LPWSTR* ppszPath)

このアドレスの URI パスを取得します。

ppszPathLPWSTR*outこのアドレスの URI パスへのポインター。このオブジェクトを解放しないでください。

戻り値

このメソッドは次のいずれかの値を返します。

返される可能性のある値には、以下のものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
E_POINTER
 ppszPath が NULL です。
vtbl 13 HRESULT SetPath(LPWSTR pszPath)

このアドレスの URI パスを設定します。

pszPathLPWSTRinこのアドレスに使用する URI パス。

戻り値

このメソッドは次のいずれかの値を返します。

返される可能性のある値には、以下のものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは正常に完了しました。
E_INVALIDARG
 pszPath の文字数が WSD_MAX_TEXT_LENGTH (8192) を超えています。
E_FAIL
 メソッドは失敗しました。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数: 
#define global IID_IWSDHttpAddress "{D09AC7BD-2A3E-4B85-8605-2737FF3E4EA0}"
#usecom global IWSDHttpAddress IID_IWSDHttpAddress "{}"
#comfunc global IWSDHttpAddress_GetSecure  10
#comfunc global IWSDHttpAddress_SetSecure  11 int
#comfunc global IWSDHttpAddress_GetPath    12 var
#comfunc global IWSDHttpAddress_SetPath    13 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。