ホーム › NetworkManagement.WindowsFirewall › INetSharingManager

INetSharingManager

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDc08956b7-1cd3-11d1-b1c5-00805fc1270e継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

INetSharingManager インターフェイスは、Manager オブジェクトの主要なインターフェイスです。INetSharingManager は、接続共有がインストールされているかどうかを判定するメソッド、ポートマッピングを管理するメソッド、およびパブリック接続とプライベート接続の列挙インターフェイスを取得するメソッドを提供します。

解説(Remarks)

ポートマッピングの列挙インターフェイスを取得するには、まず get_INetSharingConfigurationForINetConnection メソッドを使用して INetSharingConfiguration インターフェイスを取得します。次に INetSharingConfiguration::EnumPortMappings メソッドを使用して IEnumNetSharingPortMapping インターフェイスを取得します。

メソッド 6

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

vtbl 7 HRESULT get_SharingInstalled(VARIANT_BOOL* pbInstalled)

現在インストールされているバージョンの Windows XP が接続共有をサポートしているかどうかを報告します。

pbInstalled

VARIANT_BOOL*

out

現在インストールされているバージョンの Windows XP が接続共有をサポートしているかどうかを示す VARIANT_BOOL へのポインター。詳細については「解説」を参照してください。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

解説(Remarks)

このメソッドは、次のバージョンの Windows XP で呼び出された場合、pbInstalled パラメーターを TRUE に設定します。

Windows XP Home Edition
Windows XP Professional
Windows XP Embedded

それ以外のバージョンの Windows XP で呼び出された場合、この関数は pbInstalled パラメーターを FALSE に設定します。

特定の接続で共有が有効になっているかどうかを判定するには、その接続に対して INetSharingConfiguration::get_SharingEnabled メソッドを呼び出します。

vtbl 8 HRESULT get_EnumPublicConnections(SHARINGCONNECTION_ENUM_FLAGS Flags, INetSharingPublicConnectionCollection** ppColl)

EnumPublicConnections メソッドは、パブリックに共有されている接続の列挙インターフェイスを取得します。

Flags	SHARINGCONNECTION_ENUM_FLAGS	in	このパラメーターは ICSSC_DEFAULT である必要があります。
ppColl	INetSharingPublicConnectionCollection**	out	成功した場合に INetSharingPublicConnectionCollection インターフェイスを指すポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

vtbl 9 HRESULT get_EnumPrivateConnections(SHARINGCONNECTION_ENUM_FLAGS Flags, INetSharingPrivateConnectionCollection** ppColl)

get_EnumPrivateConnections メソッドは、プライベートに共有されている接続の列挙インターフェイスを取得します。

Flags	SHARINGCONNECTION_ENUM_FLAGS	in	このパラメーターは ICSSC_DEFAULT である必要があります。
ppColl	INetSharingPrivateConnectionCollection**	out	成功した場合に INetSharingPrivateConnectionCollection インターフェイスを指すポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

vtbl 10 HRESULT get_INetSharingConfigurationForINetConnection(INetConnection* pNetConnection, INetSharingConfiguration** ppNetSharingConfiguration)

get_INetSharingConfigurationForINetConnection メソッドは、指定された接続の INetSharingConfiguration インターフェイスを取得します。

pNetConnection	INetConnection*	in	インターネット接続の INetConnection インターフェイスへのポインター。
ppNetSharingConfiguration	INetSharingConfiguration**	out	成功した場合に、pNetConnection パラメーターで指定された接続の INetSharingConfiguration インターフェイスを指すインターフェイスポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

vtbl 11 HRESULT get_EnumEveryConnection(INetSharingEveryConnectionCollection** ppColl)

get_EnumEveryConnection メソッドは、接続フォルダー内のすべての接続の列挙インターフェイスを取得します。

ppColl

INetSharingEveryConnectionCollection**

out

成功した場合に INetSharingEveryConnectionCollection インターフェイスを指すポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

vtbl 12 HRESULT get_NetConnectionProps(INetConnection* pNetConnection, INetConnectionProps** ppProps)

get_NetConnectionProps メソッドは、指定された接続のプロパティインターフェイスを取得します。

pNetConnection	INetConnection*	in	プロパティインターフェイスを取得する接続の INetConnection インターフェイスへのポインター。
ppProps	INetConnectionProps**	out	成功した場合に、その接続の INetConnectionProps インターフェイスを指すインターフェイスポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	不明なエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由によりメソッドが失敗しました。

解説(Remarks)

すべての接続を共有用に構成できるわけではありません。 INetSharingManager::get_INetSharingConfigurationForINetConnection を呼び出す前に、接続のプロパティを取得して、その接続が共有可能であることを確認してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetSharingManager "{C08956B7-1CD3-11D1-B1C5-00805FC1270E}"
#usecom global INetSharingManager IID_INetSharingManager "{5C63C1AD-3956-4FF8-8486-40034758315B}"
#comfunc global INetSharingManager_get_SharingInstalled                           7 var
#comfunc global INetSharingManager_get_EnumPublicConnections                      8 int,sptr
#comfunc global INetSharingManager_get_EnumPrivateConnections                     9 int,sptr
#comfunc global INetSharingManager_get_INetSharingConfigurationForINetConnection  10 sptr,sptr
#comfunc global INetSharingManager_get_EnumEveryConnection                        11 sptr
#comfunc global INetSharingManager_get_NetConnectionProps                         12 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_INetSharingManager "{C08956B7-1CD3-11D1-B1C5-00805FC1270E}"
#usecom global INetSharingManager IID_INetSharingManager "{5C63C1AD-3956-4FF8-8486-40034758315B}"
#comfunc global INetSharingManager_get_SharingInstalled                           7 sptr
#comfunc global INetSharingManager_get_EnumPublicConnections                      8 int,sptr
#comfunc global INetSharingManager_get_EnumPrivateConnections                     9 int,sptr
#comfunc global INetSharingManager_get_INetSharingConfigurationForINetConnection  10 sptr,sptr
#comfunc global INetSharingManager_get_EnumEveryConnection                        11 sptr
#comfunc global INetSharingManager_get_NetConnectionProps                         12 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。