ホーム › Media.MediaFoundation › IMFNetProxyLocator

IMFNetProxyLocator

COM

📘 Microsoft Learn (日本語) · English

IIDe9cd0383-a268-4bb4-82de-658d53574d41継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

サーバーへの接続時に使用するプロキシを決定します。

メソッド 5

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

vtbl 3 HRESULT FindFirstProxy(LPWSTR pszHost, LPWSTR pszUrl, BOOL fReserved)

プロキシロケーターオブジェクトを初期化します。

pszHost	LPWSTR	in	接続先サーバーのホスト名を含む、null 終端のワイド文字列です。
pszUrl	LPWSTR	in	接続先の URL を含む、null 終端のワイド文字列です。
fReserved	BOOL	in	予約済みです。FALSE を設定してください。

戻り値

このメソッドは HRESULT を返します。指定される値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

vtbl 4 HRESULT FindNextProxy()

次に使用するプロキシを決定します。

戻り値

このメソッドは HRESULT を返します。指定される値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。
S_FALSE	これ以上プロキシオブジェクトはありません。

vtbl 5 HRESULT RegisterProxyResult(HRESULT hrOp)

現在のプロキシの使用が成功したか失敗したかの記録を保持します。

hrOp

HRESULT

接続に現在のプロキシを使用した結果を指定する HRESULT です。

戻り値

このメソッドは HRESULT を返します。指定される値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

vtbl 6 HRESULT GetCurrentProxy(LPWSTR pszStr, DWORD* pcchStr)

ホスト名とポートを含む現在のプロキシ情報を取得します。

pszStr	LPWSTR	outoptional	プロキシのホスト名とポートを含む null 終端文字列を受け取るバッファーへのポインターです。このパラメーターには NULL を指定できます。
pcchStr	DWORD*	inout	入力時には、pszStr 配列の要素数を指定します。出力時には、必要なバッファーサイズを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定される値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。
E_NOT_SUFFICIENT_BUFFER	pszStr に指定されたバッファーが小さすぎます。

vtbl 7 HRESULT Clone(IMFNetProxyLocator** ppProxyLocator)

既定のプロキシロケーターの新しいインスタンスを作成します。

ppProxyLocator

IMFNetProxyLocator**

out

新しいプロキシロケーターオブジェクトの IMFNetProxyLocator インターフェイスへのポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。指定される値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFNetProxyLocator "{E9CD0383-A268-4BB4-82DE-658D53574D41}"
#usecom global IMFNetProxyLocator IID_IMFNetProxyLocator "{}"
#comfunc global IMFNetProxyLocator_FindFirstProxy       3 wstr,wstr,int
#comfunc global IMFNetProxyLocator_FindNextProxy        4
#comfunc global IMFNetProxyLocator_RegisterProxyResult  5 int
#comfunc global IMFNetProxyLocator_GetCurrentProxy      6 var,var
#comfunc global IMFNetProxyLocator_Clone                7 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMFNetProxyLocator "{E9CD0383-A268-4BB4-82DE-658D53574D41}"
#usecom global IMFNetProxyLocator IID_IMFNetProxyLocator "{}"
#comfunc global IMFNetProxyLocator_FindFirstProxy       3 wstr,wstr,int
#comfunc global IMFNetProxyLocator_FindNextProxy        4
#comfunc global IMFNetProxyLocator_RegisterProxyResult  5 int
#comfunc global IMFNetProxyLocator_GetCurrentProxy      6 sptr,sptr
#comfunc global IMFNetProxyLocator_Clone                7 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。