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

IWSDScopeMatchingRule

COM
📘 Microsoft Learn (日本語) · English
IIDfcafe424-fef5-481a-bd9f-33ce0574256f継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

WS-Discovery で定義される標準のスコープ照合ルールを拡張するために使用できる、カスタムのスコープ照合ルールを提供するために、クライアントプログラム側で実装されます。

メソッド 2

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

vtbl 3 HRESULT GetScopeRule(LPWSTR* ppszScopeMatchingRule)

実装されたスコープ照合ルールを定義する URI を返すために呼び出されます。

ppszScopeMatchingRuleLPWSTR*outスコープ照合ルールへのポインター。実装側は WSDAllocateLinkedMemory を使用してメモリを割り当てる必要があり、呼び出し元は WSDFreeLinkedMemory を使用してメモリを解放する必要があります。

戻り値

戻り値には、次のものが含まれます (ただし、これらに限定されません)。

戻り値 説明
S_OK
 メソッドは正常に完了しました。

解説(Remarks)

GetScopeRule は、このオブジェクトが表すスコープ照合ルールの URI のコピーを提供する必要があります。このコピーは、呼び出し元が WSDFreeLinkedMemory を使用して解放します。

ppszScopeMatchingRule が NULL または空の文字列になることはありません。NULL スコープ照合ルールを登録するには、WS-Discovery で定義されている RFC2396 ルールを登録してください。NULL の MatchBy 値を含む Probe メッセージは、GetScopeRule が呼び出される前に RFC2396 に変換されます。

vtbl 4 HRESULT MatchScopes(LPWSTR pszScope1, LPWSTR pszScope2, BOOL* pfMatch)

2 つのスコープが一致するかどうかを判定するために比較する目的で呼び出されます。

pszScope1LPWSTRin1 つ目のスコープ照合ルールへのポインター。
pszScope2LPWSTRin2 つ目のスコープ照合ルールへのポインター。
pfMatchBOOL*outpszScope1 と pszScope2 で受け取ったスコープが一致する場合は TRUE、一致しない場合は FALSE が設定されます。

戻り値

戻り値には、次のものが含まれます (ただし、これらに限定されません)。

戻り値 説明
S_OK
 メソッドは正常に完了しました。

解説(Remarks)

MatchScopes は、指定された 2 つのスコープが一致するかどうかを判定するために、カスタムのスコープ照合ルールに対して呼び出されます。pfMatch には、一致状態を示す TRUE または FALSE のいずれかを設定する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWSDScopeMatchingRule "{FCAFE424-FEF5-481A-BD9F-33CE0574256F}"
#usecom global IWSDScopeMatchingRule IID_IWSDScopeMatchingRule "{}"
#comfunc global IWSDScopeMatchingRule_GetScopeRule  3 var
#comfunc global IWSDScopeMatchingRule_MatchScopes   4 wstr,wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。